ACOPY()
Copia elementos de un array a otro
- Syntax
-
- ACOPY( <aOrigen>, <aDestino>, [<nInicio>], [<nContador>],
- [<nPosDestino>] )--> aDestino
- Arguments
-
- <aOrigen> es el array desde el que se copian los elementos.
- <aDestino> es el array al que se copian los elementos.
- <nInicio> es la posición desde donde se inicia la copia en <aOrigen>. Por defecto es uno. <nContador> es el número de elementos a copiar comenzando en la posición <nInicio>
- <nPosDestino> es la posición de inicio en el array <aDestino> hacia donde se copian los elementos. Por defecto es uno.
- Returns
-
- ACOPY() retorna una referencia al array <aDestino>
- Description
-
- ACOPY() copia elementos desde el array <aOrigen> hacia el array <aDestino>. Esta función copia todo tipo de datos.
- Si un elemento en el array <aOrigen> es un puntero de referencia a otro array (submatriz), esa referencia será copiada al array <aDestino> pero no todas las dimensiones serán copiadas de un array al otro. Esto debe ser realizado via función ACLONE().
- Note Si el array <aOrigen> es mayor que <aDestino>, los elementos en el array comienzan a ser copiados en <nPosDestino> y continuan copiandose hasta que el final del array <aDestino> es alcanzado, los elementos que sobran en <aOrigen> se descartan. La función ACOPY() no agrega posiciones al array destino, el tamaño del array <aDestino> permanece constante.
Examples
* El ejemplo siguiente copia un array sobre otro.
LOCAL nContador := 2, nInicio := 1, aUltimo, aPrimero
aUltimo := { "HARBOUR", " es el ", "Heredero" }
aPrimero := { "CLIPPER", " fue el ", "Pionero" }
ACOPY( aUltimo, aPrimero, nInicio, nContador)
- Status
- Ready
- Compliance
-
- Esta función es totalmente compatible con CA-Clipper.
- Files
-
- El código fuente está en arrays.c La librería asociada es vm
- See Also