Click above to get retro games delivered to your door ever month!
[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
A_LEN()
Return the total number of elements in an array or a specified dimension
-------------------------------------------------------------------------------
Syntax
A_LEN( <aTarget>, [<nDimension>] ) -> nCount
Arguments
<aTarget> is the array whose elements will be counted.
<nDimension> is the dimension whose elements will be counted. If
not specified, all elements in the array will be counted.
Returns
A_LEN() returns the number of elements in the array or any one
dimension of the array.
Description
A_LEN() counts the number of declared elements in an array. If a
particular dimension is supplied in <nDimension>, then only the
number of elements in that dimension will be reported.
For example, if you declare a two dimensional array with thirty
students in the first dimension and their grades on five exams in
the second, A_LEN() will report thirty elements for the first
dimension, five elements in the second dimension or one hundred
and fifty elements in the entire array.
Examples
// Use A_LEN() to scan for the total length of an array.
LOCAL ffArray
// Declare a FlexFile string array.
ffArray = A_DECLARE( 'S', 5, 8 )
? A_LEN( ffArray ) // Result: 40
// Now use to show only the length of the second dimension.
? A_LEN( ffArray, 2 ) // Result: 8