[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
ARRAY()
Create an uninitialized array of specified length
------------------------------------------------------------------------------
Syntax
ARRAY(<nElements> [, <nElements>...]) aArray
Arguments
<nElements> is the number of elements in the specified dimension.
The maximum number of elements in a dimension is 4096. Arrays in
CA-Clipper can have an unlimited number of dimensions.
Returns
ARRAY() returns an array of specified dimensions.
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 CA-Clipper, 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.
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})
Files Library is CLIPPER.LIB.
See Also:
AADD()
ACLONE()
ACOPY()
ADEL()
AEVAL()
AFILL()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson