ASIZE()
 Aumenta ou diminui um vetor
------------------------------------------------------------------------------

 Sintaxe

     ASIZE(<aDestino>, <nTamanho>) --> aDestino

 Argumentos

     <aDestino> é o vetor a ser aumentado ou diminuido.

     <nTamanho> é o novo tamanho do vetor.

 Retorno

     ASIZE() retorna uma referência ao vetor destino, <aDestino>.

 Descriçao

     ASIZE() é uma funçao de tratamento de vetor que muda o valor real do
     vetor <aDestino>.  O vetor é diminuido ou aumentado para corresponder
     ao tamanho especificado.  Caso o vetor seja diminuido, os elementos no
     final do vetor sao perdidos.  Se o vetor for aumentado, novos elementos
     sao adicionados ao final do vetor e a eles atribuido NIL.

     ASIZE() é semelhante a AADD(), o qual adiciona somente um novo elemento
     ao final de um vetor e opcionalmente atribui um novo valor ao mesmo
     tempo.  Observe que ASIZE() é diferente de AINS() e ADEL(), os quais na
     realidade nao modificam o tamanho do vetor.

 Exemplos

     Estes exemplos demonstram a adiçao de novos elementos e a eliminaçao de
     elementos existentes:

     aArray := { 1 }                // Resulta: aArray e { 1 }
     ASIZE(aArray, 3)               // Resulta: aArray e { 1, NIL, NIL }
     ASIZE(aArray, 1)               // Resulta: aArray e { 1 }

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

See Also: AADD() ADEL() AFILL() AINS()