ARRAY()
 Cria um vetor nao inicializado de tamanho especificado
------------------------------------------------------------------------------

 Sintaxe

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

 Argumentos

     <nElementos> é a quantidade de elementos na dimensao especificada.
     O número máximo de elementos em uma dimensao é 4096.  Os vetores em
     Clipper podem ter um número ilimitado de dimensoes.

 Retorno

     ARRAY() retorna um vetor de dimensoes especificadas.

 Descriçao

     ARRAY() é uma funçao de tratamento de vetor que retorna um vetor nao
     inicializado com a quantidade especificada de elementos e dimensoes.
     Se for esepcificado mais de um argumento <nElementos>, é criado um
     vetor multi-dimensional ou aninhado, sendo que a quantidade de
     dimensoes é igual à quantidade de argumentos <nElementos> especificada.

     No Clipper 5.0, há várias formas de se criar um vetor.  Você pode
     declarar um vetor utilizando LOCAL ou STATIC; você pode criar um vetor
     utilizando PRIVATE ou PUBLIC; você pode atribuir um vetor literal a uma
     variável existente; ou você pode usar a funçao ARRAY().  ARRAY() tem a
     vantagem de possibilitar a você a criaçao de vetores dentro de
     expressoes ou blocos de código.

 Exemplos

       Este exemplo cria um vetor unidimensional de cinco elementos
        utilizando a funçao ARRAY(), e depois exibe a açao equivalente
        atribuindo um vetor literal de valores NIL:

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

       Este exemplo ilustra três declaraçoes diferentes que criam o
        mesmo vetor multi-dimensional:

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

 Arquivos:  Biblioteca CLIPPER.LIB.
 To download this example - click here.

See Also: AADD() ADEL() AFILL() AINS() LOCAL PUBLIC STATIC