ACOPY()
 Copia elementos de una matriz a otra
------------------------------------------------------------------------------
 Sintaxis

     ACOPY(<aFuente>, <aDestino>, [<nInicio>],
        [<nPosiciones>], [<nPosDestino>]) --> aDestino

 Argumentos

     <aFuente> es la matriz cuyos elementos se van a copiar.

     <aDestino> es la matriz en la que se van a copiar los elementos.

     <nInicio> es la posición del elemento inicial de la matriz
     <aFuente>. Si no se especifica, el valor por defecto es uno.

     <nPosiciones> es el número de elementos que se van a copiar de
     <aFuente>, comenzando en la posición <nInicio>. Si no se especifica
     <nPosiciones>, se copian todos los elementos de <aFuente> desde el
     elemento inicial.

     <nPosDestino> es la posición del elemento inicial de la matriz
     <aDestino> que va a recibir los elementos de <aFuente>. Si no se
     especifica, el valor por defecto es uno.

 Devuelve

     ACOPY() devuelve una referencia a la matriz destino, <aDestino>.

 Descripción

     ACOPY() es una función de matrices que copia elementos de la matriz
     <aFuente> en la matriz <aDestino>. La matriz <aDestino> debe existir
     previamente y debe ser lo suficientemente grande para almacenar los
     elementos copiados. Si la matriz <aFuente> tiene más elementos, algunos
     de ellos no se copiarán.

     ACOPY() copia valores de cualquier tipo de datos, incluyendo NIL y
     bloques de código. Si un elemento de la matriz <aFuente> es una
     submatriz, el elemento correspondiente de la matriz <aDestino>
     contendrá una referencia a la submatriz. Por tanto, ACOPY() no creará
     un duplicado completo de una matriz multidimensional. Para ello, es
     necesario utilizar la función ACLONE().

 Ejemplos

      El ejemplo siguiente crea dos matrices, cada una de las cuales
        se llena con un valor. A continuación, los dos primeros elementos de
        la matriz fuente se copian en la matriz destino:

        LOCAL nPosiciones := 2, nInicio := 1, aUno, aDos
        aUno := { 1, 1, 1 }
        aDos := { 2, 2, 2 }
        ACOPY(aUno, aDos, nInicio, nPosiciones)
        // Resultado: aDos ahora es { 1, 1, 2 }

 Ficheros   La biblioteca asociada es CLIPPER.LIB.

 To download this example - click here.

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