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

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.

 Examples

      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