Field Target References - Revision history

Rob at 13:16, 7 December 2008

2008-12-07T13:16:19Z

← Older revision		Revision as of 13:16, 7 December 2008
Line 1:		Line 1:
	{{context\|Kit Reference\|Target References}}		{{context\|Kit Reference\|Target References}}

			See Also: [[Field Context Transitions]]

	There are a variety of ways to access and manipulate the contents of fields. The complete list of target references for fields is presented in the table below.		There are a variety of ways to access and manipulate the contents of fields. The complete list of target references for fields is presented in the table below.

Rob at 03:48, 7 December 2008

2008-12-07T03:48:27Z

← Older revision		Revision as of 03:48, 7 December 2008
Line 54:		Line 54:
	\|-		\|-
	\|arraydump		\|arraydump
	\|(Right, String) Generates and returns a text string ~~the~~ contains the values of all elements in the array, with the results appropriately formatted for easy viewing. This mechanism is ideal for use within "debug" statements to help isolate scripting problems with arrays. Only usable with array-based fields.<br>		\|(Right, String) Generates and returns a text string that contains the values of all elements in the array, with the results appropriately formatted for easy viewing. This mechanism is ideal for use within "debug" statements to help isolate scripting problems with arrays. Only usable with array-based fields.<br>
	Example: result = this.field[myfield].arraydump<br>		Example: result = this.field[myfield].arraydump<br>
	{{note}}The generated output is capped to the limits of the debug output mechanism, so using this mechanism with large arrays and/or text-based fields may result in the output being truncated.		{{note}}The generated output is capped to the limits of the debug output mechanism, so using this mechanism with large arrays and/or text-based fields may result in the output being truncated.
	\|-		\|-
	\|matrixdump		\|matrixdump
	\|(Right, String) Generates and returns a text string ~~the~~ contains the values of all elements in the matrix, with the results appropriately formatted for easy viewing. This mechanism is ideal for use within "debug" statements to help isolate scripting problems with matrices. Only usable with matrix-based fields.<br>		\|(Right, String) Generates and returns a text string that contains the values of all elements in the matrix, with the results appropriately formatted for easy viewing. This mechanism is ideal for use within "debug" statements to help isolate scripting problems with matrices. Only usable with matrix-based fields.<br>
	Example: result = this.field[myfield].matrixdump<br>		Example: result = this.field[myfield].matrixdump<br>
	{{note}}The generated output is capped to the limits of the debug output mechanism, so using this mechanism with large matrices and/or text-based fields may result in the output being truncated.		{{note}}The generated output is capped to the limits of the debug output mechanism, so using this mechanism with large matrices and/or text-based fields may result in the output being truncated.
Line 68:		Line 68:
	\|-		\|-
	\|history[''spl'']		\|history[''spl'']
	\|(Right, String)		\|(Right, String) Generates and returns a text string that contains the change history for the field. The ''spl'' parameter is a string that is inserted between entries in the change history, splicing them together for appropriate output. The history report contents depend on the history behavior assigned to the field, as given below:
			<ul class="sets">
			<li>best – Only the notes text for each history entry is reported</li>
			<li>stack – The notes text for each entry is reported and the adjustment details are included in parentheses with the notes (e.g. "notes (+2)")</li>
			</ul>
	\|-		\|-
	\|}		\|}

Rob at 03:35, 7 December 2008

2008-12-07T03:35:40Z

← Older revision		Revision as of 03:35, 7 December 2008
Line 64:		Line 64:
	\|-		\|-
	\|modify[''oper'',''val'',''str'']		\|modify[''oper'',''val'',''str'']
	\|(Right, Number)		\|(Right, Number) Applies a modification to the field with accompanying notes for tracking a history of changes. The modification nature is given by the ''oper'' parameter, which must be one of the standard arithmetic operators: '+', '-', '*', '/'. The ''val'' parameter is an arithmetic expression the provides the modification value to be applied. The ''str'' parameter is a text annotation that is recorded along with the modification. If ''str'' is the empty string, the notes are the name of the initial pick context that is applying the change (or "?????" if the initial context is not a pick). The field must be explicitly configured to support history tracking. Always returns a value of zero.<br>
			Example: perform this.field[myfield].modify[+,1,"first"]
	\|-		\|-
	\|history[''spl'']		\|history[''spl'']

Rob at 03:28, 7 December 2008

2008-12-07T03:28:22Z

← Older revision		Revision as of 03:28, 7 December 2008
Line 54:		Line 54:
	\|-		\|-
	\|arraydump		\|arraydump
	\|(Right, String)		\|(Right, String) Generates and returns a text string the contains the values of all elements in the array, with the results appropriately formatted for easy viewing. This mechanism is ideal for use within "debug" statements to help isolate scripting problems with arrays. Only usable with array-based fields.<br>
			Example: result = this.field[myfield].arraydump<br>
			{{note}}The generated output is capped to the limits of the debug output mechanism, so using this mechanism with large arrays and/or text-based fields may result in the output being truncated.
	\|-		\|-
	\|matrixdump		\|matrixdump
	\|(Right, String)		\|(Right, String) Generates and returns a text string the contains the values of all elements in the matrix, with the results appropriately formatted for easy viewing. This mechanism is ideal for use within "debug" statements to help isolate scripting problems with matrices. Only usable with matrix-based fields.<br>
			Example: result = this.field[myfield].matrixdump<br>
			{{note}}The generated output is capped to the limits of the debug output mechanism, so using this mechanism with large matrices and/or text-based fields may result in the output being truncated.
	\|-		\|-
	\|modify[''oper'',''val'',''str'']		\|modify[''oper'',''val'',''str'']

Rob at 03:23, 7 December 2008

2008-12-07T03:23:46Z

← Older revision		Revision as of 03:23, 7 December 2008
Line 34:		Line 34:
	\|-		\|-
	\|arrayvalue[''row'']		\|arrayvalue[''row'']
	\|(Left, Right, Number)		\|(Left, Right, Number) Accesses the contents of a specific element of the array-based field as a numeric value. The index of the element is given by ''row'', where the index is a zero-based value that must be less than the number of rows in the array. If the field is text and the contents retrieved, the contents are automatically converted to a suitable value.<br>
			Example: result = this.field[myfield].arrayvalue[3]<br>
			Example: this.field[myfield].arrayvalue[3] = 42
	\|-		\|-
	\|arraytext[''row'']		\|arraytext[''row'']
	\|(Left, Right, Number)		\|(Left, Right, Number) Accesses the contents of a specific element of the array-based field as a string. The index of the element is given by ''row'', where the index is a zero-based value that must be less than the number of rows in the array. If the field is numeric can the contents retrieved, the contents are automatically converted to a suitable string.<br>
			Example: result = this.field[myfield].arraytext[3]<br>
			Example: this.field[myfield].arraytext[3] = "hello"
	\|-		\|-
	\|matrixvalue[''row'',''col'']		\|matrixvalue[''row'',''col'']
	\|(Left, Right, Number)		\|(Left, Right, Number) Accesses the contents of a specific element of the matrix-based field as a numeric value. The index of the element is given by ''row'' and ''col'', where the indices are zero-based values that must be less than the number of rows and columns in the matrix, respectively. If the field is text and the contents retrieved, the contents are automatically converted to a suitable value.<br>
			Example: result = this.field[myfield].matrixvalue[3,4]<br>
			Example: this.field[myfield].matrixvalue[3,4] = 42
	\|-		\|-
	\|matrixtext[''row'',''col'']		\|matrixtext[''row'',''col'']
	\|(Left, Right, String)		\|(Left, Right, String) Accesses the contents of a specific element of the matrix-based field as a string. The index of the element is given by ''row'' and ''col'', where the indices are zero-based values that must be less than the number of rows and columns in the matrix, respectively. If the field is numeric and the contents retrieved, the contents are automatically converted to a suitable string.<br>
			Example: result = this.field[myfield].matrixvalue[3,4]<br>
			Example: this.field[myfield].matrixvalue[3,4] = 42
	\|-		\|-
	\|arraydump		\|arraydump

Rob at 03:19, 7 December 2008

2008-12-07T03:19:00Z

← Older revision		Revision as of 03:19, 7 December 2008
Line 6:		Line 6:

	:{\| class="infotable"		:{\| class="infotable"
	\|class="leftnormal"\|~~text~~		\|class="leftnormal"\|value
	\|(Left, Right, ~~String~~)		\|(Left, Right, Number) Accesses the contents of the field as a numeric value. If the field is text and the contents retrieved, the contents are automatically converted to a suitable value.<br>
			Example: result = this.field[myfield].value<br>
			Example: this.field[myfield].value = 42
	\|-		\|-
	\|~~value~~		\|text
	\|(Left, Right, ~~Number~~)		\|(Left, Right, String) Accesses the contents of the field as a string. If the field is numeric can the contents retrieved, the contents are automatically converted to a suitable string.<br>
			Example: result = this.field[myfield].text<br>
			Example: this.field[myfield].text = "hello"
	\|-		\|-
	\|isempty		\|isempty
	\|(Right, Number)		\|(Right, Number) Returns non-zero if the field contains the empty string and zero if it contains text of any length. If used on a numeric field or with an array or matrix, an error is reported. Testing of array and matrix elements must be done via the "compare" intrinsic.<br>
			Example: result = this.field[myfield].isempty
	\|-		\|-
	\|reset		\|reset
	\|(Right, Number)		\|(Right, Number) The contents of the field are reset to the initial default value for the thing. A value of zero is always returned.<br>
			Example: perform this.field[myfield].reset
	\|-		\|-
	\|ischosen		\|ischosen
	\|(Right, Number)		\|(Right, Number) Returns non-zero if the field contains a pick or a thing that was selected via a menu. If the field is associated with a menu and no selection has yet been made, zero is returned.<br>
			Example: result = this.field[myfield].ischosen
	\|-		\|-
	\|delta		\|delta
	\|(Left, Right, Number)		\|(Left, Right, Number) Accesses the delta component of a user field for manipulation separately from the user-specified value. The field must be explicitly configured to support delta processing.<br>
			Example: result = this.field[myfield].delta<br>
			Example: this.field[myfield].delta = 2
	\|-		\|-
	\|arrayvalue[''row'']		\|arrayvalue[''row'']

Rob at 03:06, 7 December 2008

2008-12-07T03:06:23Z

← Older revision		Revision as of 03:06, 7 December 2008
Line 11:		Line 11:
	\|value		\|value
	\|(Left, Right, Number)		\|(Left, Right, Number)
			\|-
			\|isempty
			\|(Right, Number)
	\|-		\|-
	\|reset		\|reset
Line 16:		Line 19:
	\|-		\|-
	\|ischosen		\|ischosen
	~~\|(Right, Number)~~
	\|-
	~~\|isempty~~
	\|(Right, Number)		\|(Right, Number)
	\|-		\|-
	\|delta		\|delta
	\|(Left, Right, Number)		\|(Left, Right, Number)
	\|-
	~~\|arraydump~~
	~~\|(Right, String)~~
	\|-
	~~\|matrixdump~~
	~~\|(Right, String)~~
	\|-		\|-
	\|arrayvalue[''row'']		\|arrayvalue[''row'']
Line 41:		Line 35:
	\|matrixtext[''row'',''col'']		\|matrixtext[''row'',''col'']
	\|(Left, Right, String)		\|(Left, Right, String)
			\|-
			\|arraydump
			\|(Right, String)
			\|-
			\|matrixdump
			\|(Right, String)
	\|-		\|-
	\|modify[''oper'',''val'',''str'']		\|modify[''oper'',''val'',''str'']

Rob: New page: {{context|Kit Reference|Target References}} There are a variety of ways to access and manipulate the contents of fields. The complete list of target references for fields is presented in ...

2008-12-07T03:02:58Z

New page: {{context|Kit Reference|Target References}} There are a variety of ways to access and manipulate the contents of fields. The complete list of target references for fields is presented in ...

New page

{{context|Kit Reference|Target References}}

There are a variety of ways to access and manipulate the contents of fields. The complete list of target references for fields is presented in the table below.

{{note}}When a field is accessed from within a thing or a visual script, all operations are restricted to read-only behavior. Any attempts to modify a field from within a thing context or via a visual script will fail.

:{| class="infotable"
|class="leftnormal"|text
|(Left, Right, String)
|-
|value
|(Left, Right, Number)
|-
|reset
|(Right, Number)
|-
|ischosen
|(Right, Number)
|-
|isempty
|(Right, Number)
|-
|delta
|(Left, Right, Number)
|-
|arraydump
|(Right, String)
|-
|matrixdump
|(Right, String)
|-
|arrayvalue[''row'']
|(Left, Right, Number)
|-
|arraytext[''row'']
|(Left, Right, Number)
|-
|matrixvalue[''row'',''col'']
|(Left, Right, Number)
|-
|matrixtext[''row'',''col'']
|(Left, Right, String)
|-
|modify[''oper'',''val'',''str'']
|(Right, Number)
|-
|history[''spl'']
|(Right, String)
|-
|}