$FUNCNAME$
  ARRAY()
$CATEGORY$
  ARRAY
$SUMMARY$
   Create an uninitialized array of specified length
$LANG_RU$
       .
$SYNTAX$
     ARRAY(<nElements> [, <nElements>...]) --> aArray
$LANG_RU$
     ARRAY(<- . 1> [,<- . 2>...]) --> 
$ARGUMENTS$
     <nElements> is the number of elements in the specified dimension.
     The maximum number of elements in a dimension is 65000.  Arrays in
     xClipper can have an unlimited number of dimensions.
$LANG_RU$
     <- .> -     .
           
     65000.       .
$RETURNS$
     ARRAY() returns an array of specified dimensions.
$LANG_RU$
     ARRAY()    .
$DESCRIPTION$

     ARRAY() is an array function that returns an uninitialized array with
     the specified number of elements and dimensions.  If more than one
     <nElements> argument is specified, a multidimensional array is created
     with the number of dimensions equal to the number of <nElements>
     arguments specified.  Any <nElements> that is itself an array creates a
     nested array.

     In xClipper, there are several ways to create an array.  You can
     declare an array using a declaration statement such as LOCAL or STATIC;
     you can create an array using a PRIVATE or PUBLIC statement; you can
     assign a literal array to an existing variable; or you can use the
     ARRAY() function.  ARRAY() has the advantage that it can create arrays
     within expressions or code blocks.


$LANG_RU$

     ARRAY() -    ,  
          
      .      <- .>,
      "",     
     ,     <- .>.

     xClipper     .
            , 
     LOCAL  STATIC;   ,   PUBLIC
      PRIVATE;      
     , ,   ARRAY().  ARRAY()
     ,    , 
        .


$EXAMPLES$

       This example creates a one-dimensional array of five elements
	using the ARRAY() function, and then shows the equivalent action by
	assigning a literal array of NIL values:

	aArray := ARRAY(5)
	aArray := { NIL, NIL, NIL, NIL, NIL }

       This example shows three different statements which create the
	same multidimensional array:

	aArray := ARRAY(3, 2)
	aArray := { {NIL, NIL}, {NIL, NIL}, {NIL, NIL} }
	aArray := { ARRAY(2), ARRAY(2), ARRAY(2) }

       This example creates a nested, multidimensional array:

	aArray := ARRAY(3, {NIL,NIL})


$LANG_RU$

             , 
        ARRAY()      ,  
         NIL :

       aArray := ARRAY(5)
       aArray := { NIL, NIL, NIL, NIL, NIL }

           ,  
             :

       aArray := ARRAY( 3, 2 )
       aArray := {{ NIL, NIL },{ NIL, NIL },{ NIL, NIL }}
       aArray := { ARRAY(2), ARRAY(2), ARRAY(2) }


$SEEALSO$
  AADD(),ACLONE(),ACOPY(),ADEL(),AEVAL(),AFILL(),AINS()
$END$
