ARRAY()
 Crea una matriz de una longitud especificada, sin inicializar
------------------------------------------------------------------------------
 Sintaxis

     ARRAY(<nElementos> [, <nElementos>...]) --> aMatriz

 Argumentos

     <nElementos> es el número de elementos de la dimensión
     especificada. El número máximo de elementos de una dimensión es 4096.
     Las matrices de CA-Clipper pueden tener un número de dimensiones
     ilimitado.

 Devuelve

     ARRAY() devuelve una matriz con las dimensiones especificadas.

 Descripción

     ARRAY() es una función de matrices que devuelve una matriz no
     inicializada con el número de elementos y dimensiones especificado. Si
     se especifica más de un argumento <nElementos>, se creará una matriz
     multidimensional con un número de dimensiones igual al número de
     argumentos <nElementos> especificado. Si algún argumento <nElementos>
     es una matriz, se crea una matriz anidada.

     En CA-Clipper, existen varias formas de crear una matriz. Puede
     declararse utilizando una sentencia LOCAL o STATIC; también puede
     crearse con una declaración PRIVATE o PUBLIC; puede asignarse una
     matriz en forma literal a una variable existente o puede usarse la
     función ARRAY(). ARRAY() tiene la ventaja de que permite crear matrices
     dentro de expresiones o bloques de código.

 Ejemplos

      El ejemplo siguiente crea una matriz unidimensional de cinco
        elementos utilizando la función ARRAY(). Luego, muestra la acción
        equivalente asignando una matriz literal con valores NIL:

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

      El ejemplo siguiente muestra tres sentencias distintas que
        crean la misma matriz multidimensional:

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

      El ejemplo siguiente crea una matriz anidada
        multidimensional:

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

 Ficheros   La biblioteca asociada es CLIPPER.LIB.

 To download this example - click here.

See Also: AADD() ACLONE() ACOPY() ADEL() AEVAL() AFILL()