Changes
Jump to navigation
Jump to search
Created page with "Used in function input declaration statements to define an input as Passed by Reference String Array with a specified number of dimensions. Declaring an input as Passed by Re..."
Used in function input declaration statements to define an input as Passed by Reference String Array with a specified number of dimensions.
Declaring an input as Passed by Reference enables the function to modify the values of variables passed as the input.
==== Usage ====
<syntaxhighlight>Input:InputName[M1,M2,M3,etc.](StringArrayRef)</syntaxhighlight>
==== Parameters ====
[[InputName]] - an expression specifying the input name
The name can consist of letters, underscore characters, numbers, and periods.
The name cannot begin with a number or a period and is not case-sensitive.
M - an input variable that represents the maximum index value for each dimension of the array passed to the function; a single input variable specifies a one-dimensional array input, two input variables specify a two-dimensional (M1 by M2) array input, three input variables specify a three-dimensional (M1 by M2 by M3) array input, etc.
An input will only accept an array with the specified number of dimensions.
==== Example ====
Declare Messages as a Passed by Reference one-dimensional String Array function input:
<syntaxhighlight>Input:Messages[X](StringArrayRef);</syntaxhighlight>
The maximum index value for the array passed to the function will be assigned to input variable X.
Declare CommentsTable as a Passed by Reference three-dimensional String Array function input:
<syntaxhighlight>Input:CommentsTable[X,Y,Z](StringArrayRef);</syntaxhighlight>
The maximum index value for each dimension of the array passed to the function will be assigned to input variables X, Y, and Z.
[[Category:Declaration]]
Declaring an input as Passed by Reference enables the function to modify the values of variables passed as the input.
==== Usage ====
<syntaxhighlight>Input:InputName[M1,M2,M3,etc.](StringArrayRef)</syntaxhighlight>
==== Parameters ====
[[InputName]] - an expression specifying the input name
The name can consist of letters, underscore characters, numbers, and periods.
The name cannot begin with a number or a period and is not case-sensitive.
M - an input variable that represents the maximum index value for each dimension of the array passed to the function; a single input variable specifies a one-dimensional array input, two input variables specify a two-dimensional (M1 by M2) array input, three input variables specify a three-dimensional (M1 by M2 by M3) array input, etc.
An input will only accept an array with the specified number of dimensions.
==== Example ====
Declare Messages as a Passed by Reference one-dimensional String Array function input:
<syntaxhighlight>Input:Messages[X](StringArrayRef);</syntaxhighlight>
The maximum index value for the array passed to the function will be assigned to input variable X.
Declare CommentsTable as a Passed by Reference three-dimensional String Array function input:
<syntaxhighlight>Input:CommentsTable[X,Y,Z](StringArrayRef);</syntaxhighlight>
The maximum index value for each dimension of the array passed to the function will be assigned to input variables X, Y, and Z.
[[Category:Declaration]]