Click above to get retro games delivered to your door ever month!

 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