ACOPY()
 Copia elementos de um vetor para outro
------------------------------------------------------------------------------

 Sintaxe

     ACOPY(<aFonte>, <aDestino>,
        [<nInicio>], [<nCont>],  [<nPosDestino>]) --> aDestino

 Argumentos

     <aFonte> é o vetor de onde serao copiados os elementos.

     <aDestino> é o vetor para onde serao copiados os elementos.

     <nInicio> é a posiçao do elemento inicial no vetor <aFonte>.  Se
     nao for especificado, o valor assumido é um.

     <nCont> é a quantidade de elementos a serem copiados do vetor
     <aFonte> a partir da posiçao <nInicio>.  Caso <nCont> nao seja
     especificado, todos os elementos em <aFonte> que começam com o elemento
     inicial sao copiados.

     <nPosDestino> é a posiçao do elemento inicial no vetor <aDestino>
     que receberá os elementos de <aFonte>.  Se nao for especificado, o
     valor padrao é um.

 Retorno

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

 Descriçao

     ACOPY() é uma funçao de tratamento de vetor que copia elementos do
     vetor <aFonte> para o vetor <aDestino>.  O vetor <aDestino> já deve
     existir e ser grande o suficiente para conter os elementos copiados.
     Caso o vetor <aFonte> tenha mais elementos, alguns elementos nao serao
     copiados.

     ACOPY() copia valores de todos os tipos de dados, inclusive NIL e
     blocos de código.  Se um elemento do vetor <aFonte> for um sub-vetor, o
     elemento correspondente no vetor <aDestino> conterá uma referência ao
     sub-vetor.  Consequentemente, ACOPY() nao cria duplicatas completas de
     vetores multi-dimensionais.  Para  fazer isto, use a funçao ACLONE().

 Exemplos

     Este exemplo cria dois vetores, cada um deles preenchido com um valor.
     Os dois primeiros elementos do vetor fonte sao entao copiados para o
     vetor destino:

     LOCAL nCount := 2, nStart := 1, aOne, aTwo
     aOne := { 1, 1, 1 }
     aTwo := { 2, 2, 2 }
     ACOPY(aOne, aTwo, nStart, aCont)   // Resulta: aTwo e agora { 1, 1, 2 }

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

See Also: ACLONE() ADEL() AEVAL() AFILL() AINS() ASORT()