AADD()
 Adiciona um novo elemento ao final de um vetor
------------------------------------------------------------------------------

 Sintaxe

     AADD(<aDestino>, <expValor>) --> Valor

 Argumentos

     <aDestino> é o vetor ao qual será adicionado um novo elemento.

     <expValor> é o valor atribuido ao novo elemento.

 Retorno

     A funçao AADD() avalia <expValor> e retorna seu valor.  Caso <expValor>
     nao seja especificado, AADD() retorna NIL.

 Descriçao

     AADD() é uma funçao de tratamento de vetor que adiciona um elemento ao
     vetor.  Ao elemento de vetor recém criado é atribuido o valor
     especificado por <expValor>.

     AADD() é utilizado para aumentar o tamanho de um vetor dinamicamente.
     É útil na construçao de filas ou listas dinâmicas.  Um bom exemplo
     disto é o vetor de GetList utilizado pelo sistema de GETs para guardar
     objetos GET.  Após um comando READ ou CLEAR GETS, GetList torna-se um
     vetor vazio.  Cada vez que você executa um comando @...GET, o sistema
     de GETs utiliza a funçao AADD() para adicionar um novo elemento ao
     final do vetor da GetList, e a partir daí adiciona um novo objeto GET
     ao novo elemento.

     AADD() é semelhante à funçao ASIZE(), mas adiciona apenas um elemento
     por vez; ASIZE() pode aumentar ou diminuir um vetor a um tamanho
     especificado.  AADD(), porém, possui a vantagem de poder atribuir um
     valor ao novo elemento, enquanto que ASIZE() nao pode.  AADD() pode
     também parecer ser igual a AINS(), mas isso nao é verdade:  AINS() move
     elementos dentro de um vetor, mas nao modifica o tamanho do vetor.

     -----------------------------------------------------------------------
     . Nota

     Caso <expValor> seja um outro vetor, o novo elemento no vetor destino
     conterá uma referência ao vetor especificado por <expValor>.
     -----------------------------------------------------------------------

 Exemplos

     Os exemplos a seguir demonstram os efeitos de invocaçoes múltiplas da
     funçao AADD() para um vetor:

     aArray := {}                 // Resulta: aArray e um vetor vazio
     AADD(aArray, 5)              // Resulta: aArray e { 5 }
     AADD(aArray, 10)             // Resulta: aArray e { 5, 10 }
     AADD(aArray, { 12, 10 })     // Resulta: aArray e { 5, 10, { 12, 10 } }

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

See Also: AINS() ASIZE()