$ArrSize: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
|||
| Line 1: | Line 1: | ||
<p>The $ | <p>The $ArrSize function returns the number of elements in a particular dimension of a named array. This function is useful for users who pass entire arrays as parameters to a subroutine and then must know the size of the array supplied as the actual argument. For more information about passing arrays to a subroutine, refer to [[Flow of control in User Language#Index loops|Index loops]]. </p> | ||
<b>Syntax</b> | <b>Syntax</b> | ||
<p>The format of the $ | <p>The format of the $ArrSize function is:</p> | ||
<p class="code">$ | <p class="code">$ArrSize (name, dimension) | ||
</p> | </p> | ||
<p>where:</p> | <p>where:</p> | ||
Revision as of 13:38, 8 July 2014
The $ArrSize function returns the number of elements in a particular dimension of a named array. This function is useful for users who pass entire arrays as parameters to a subroutine and then must know the size of the array supplied as the actual argument. For more information about passing arrays to a subroutine, refer to Index loops.
Syntax
The format of the $ArrSize function is:
$ArrSize (name, dimension)
where:
- name is a string that specifies the name of an array.
- dimension is a number that indicates the dimension of the named array for which the number of elements should be returned. Dimension can contain an expression whose value is 1, 2, or 3.
Example
FOR %I FROM 1 TO $arrsize ('%COMM.ARRAY',1)
causes %I to iterate from 1 to the number of elements in dimension 1 of the array %COMM.ARRAY.