ACopy

Copia os elementos de uma array para outra.

Sintaxe

ACOPY( aOrigem, aDestino , [ nInicio ], [ nQtde ], [ nPosDestino ]) –> aDestino

Descrição

ACOPY() é uma função de array que copia elementos do array aOrigem para array aDestino. O array destino aDestino já deve ter sido declarado e grande o bastante para conter os elementos que serão copiados.

Se o array aOrigem contiver mais elementos, alguns dos elementos não serão copiados. ACOPY() copia os valores de todos os dados, incluindo valores nulos (NIL) e códigos de bloco.

Se um elemento for um subarray, o elemento correspondente no array aDestino, conterá o mesmo subarray. Portanto, ACOPY() não produzirá uma cópia completa de array multidimensionais, Para fazer isso, uso a função aClone().

Exemplos

Este exemplo cria dois arrays, com um conteúdo cada. Os dois primeiros elementos do array fonte são então copiados no array destino:

LOCAL nCount := 2, nStart := 1, aOne, aTwo

aOne := { 1, 1, 1 }

aTwo := { 2, 2, 2 }

ACOPY(aOne, aTwo, nStart, nCount)

// Result: aTwo is now { 1, 1, 2 }