ARRAY()

Create an uninitialized array of specified length

Syntax

ARRAY( <nElements> [, <nElements>...] ) --> aArray

Arguments

<nElements> is the number of elements in the specified dimension.

Returns

<aArray> an array of specified dimensions.

Description

This function returns an uninitialized array with the length of <nElements>. Nested arrays are uninitialized within the same array pointer reference if additional parameters are specified. Establishing a memory variable with the same name as the array may destroy the original array and release the entire contents of the array. This depends, of course, on the data storage type of either the array or the variable with the same name as the array.

      FUNCTION Main()
        LOCAL aArray:=Array(10)
        LOCAL x:=1
        FOR x:=1 to LEN(aArray)
          aArray[x]:=Array(x)
        NEXT
        Return Nil

Status

Ready

Compliance

This function is CA-CLIPPER Compliant in all Cases, except that arrays in Harbour can have an unlimited number of dimensions, while Clipper has a limit of 4096 array elements.

Files

Library is vm

See Also

• AADD()
• ADEL()
• AFILL()
• AINS()