ACLONE()

Duplica un array anidado ó multidimensional

Syntax

ACLONE( <aOrigen> ) --> aDuplicado

Arguments

<aOrigen> es el nombre del array a ser clonado.

Returns

ACLONE() retorna <aDuplicate> un nueva referencia a otro array exactamente igual al original.

Description

Esta función realiza una copia completa del array llamado <aOrigen>. Crea todas las dimensiones en el array <aDestino> que existen en el array original y luego llena cada dimensión con los mismos valores de los elementos en el original. Ambos arrays coexisten como entidades distintas.
Examples
      * El ejemplo siguiente crea un array bidimensional y lo duplica.
        Se muestra que son copiadas ambas dimensiones.

        LOCAL aOrigen, aDestino
        aOrigen  := { {1, 2}, {3, 4}, {5, 6}, {7, 8}, {9, 10} }
        aDestino := ACLONE( aOrigen )

        * primera dimensión
        ? "Impares son: "                // Resultado: es {1, 3, 5, 7, 9}
        FOR n := 1 TO LEN( aDestino)
            ?? aDestino [n][1]
        NEXT

        * segunda dimensión
        ? "Pares   son: "                // Resultado: es {2, 4, 6, 8, 10}
        FOR n := 1 TO LEN( aDestino)
            ?? aDestino [n][2]
        NEXT

Status

Ready

Compliance

Clipper retorna NIL si el parámetro no es un array.

Files

El código fuente está en arrays.c La librería asociada es vm

See Also