ACOPY()

Sintaxis

ACOPY(   <array 1>, <array 2>

             [ , <expresión numérica 1> ]

             [ , <expresión numérica 2> ]

             [ , <expresión numérica 3> ] )

Propósito

La función ACOPY() copia los elementos de un array unidimensional a otro, suministrando una referencia del array copiado.

Argumentos

< array 1 >

Define el nombre del array del cual se copiará los elementos. Es decir, el array origen.

< array 2 >

Define el nombre del array al cual se copiará los elementos. Es decir, el array destino.

< expresión numérica 1 >

Define el número del primer elemento del array 1 que se copiará. Si no se especifica se asumirá el número 1.

< expresión numérica 2 >

Define el número de elementos del array 1 que se copiarán a partir del elemento definido por la expresión numérica 1. Si no se especifica se copiarán todos los elementos.

< expresión numérica 3 >

Define el número del primer elemento del array 2 a partir del cual debe iniciarse la copia. Si no se especifica se asumirá el número 1.

Utilización

La función ACOPY() constituye un medio muy rápido y eficaz de copiarse un array entero, o parte de este, a otro array. La copia podrá iniciarse a partir de un determinado elemento y realizarse para un determinado elemento del array destino.

El array destinatario de la copia debe existir previamente y tener capacidad suficiente para recibir los elementos copiados. Si el array origen tiene más elementos que el array destino, algunos elementos pueden dejar de copiarse.

Sugerencias

La función ACOPY() copia valores de cualquier tipo de dato, incluso el valor NIL y bloques de código.

Si un elemento del array origen es un subarray, el elemento correspondiente en el array destino recibirá una referencia de este subarray. Por lo tanto, la función ACOPY() no crea una copia completa de un array multidimensional. Para ello debe utilizarse la función ACLONE().

Ejemplos

En el siguiente ejemplo, la función ACOPY() se utiliza para copiar elementos del array aVetor1 al array aVetor2:

LOCAL aVetor1[4]

LOCAL aVetor2[3]

aVetor1 := { 1, 2, 3, 4 }

aVetor2 := { 0, 0, 0 }

ACOPY(aVetor1, aVetor2, 3, 2, 2)

El array aVetor2 contendrá los siguientes elementos:

aVetor2 --> { 0, 3, 4 }