ACOPY( ) (Función)
Copia elementos de una matriz a otra.
ACOPY(SourceArrayName, DestinationArrayName
[, nFirstSourceElement [, nNumberElements [, nFirstDestElement ]]])
Valores devueltos
Numeric
Parámetros
SourceArrayName, DestinationArrayName
Especifica la matriz de origen SourceArrayName cuyos elementos se copian uno a uno a la matriz de destino DestinationArrayName. Los elementos de la matriz de origen sustituyen a los elementos de la matriz de destino.Las matrices pueden ser unidimensionales o bidimensionales. Si la matriz de destino no existe, Visual FoxPro la creará automáticamente. En tal caso, el tamaño de la matriz de destino será el mismo que el de la matriz de origen.
Nota Puede hacer referencia a un elemento de una matriz bidimensional de variables de dos formas. La primera utiliza dos subíndices para especificar la posición de fila y columna del elemento de la matriz; la otra utiliza un número de elemento único. Esta función y otras que manipulan matrices bidimensionales precisan números de elemento único (aquí, nFirstSourceElement y nFirstDestElement). Utilice AELEMENT( ) para devolver el número de elemento apropiado para una matriz bidimensional a partir de sus subíndices de fila y columna.
nFirstSourceElement
Especifica el número del primer elemento de la matriz de origen que se va a copiar, inclusive (el elemento número nFirstSourceElement se incluye en la copia). Si no se incluye nFirstSourceElement, la operación de copia comenzará con el primer elemento de la matriz de origen.nNumberElements
Especifica el número de elementos copiados de la matriz de origen. Si nNumberElements es –1, se copiarán todos los elementos de la matriz de origen a partir del elemento nFirstSourceElement.nFirstDestElement
Especifica el primer elemento de la matriz de destino que se va a sustituir.
Observaciones
ACOPY( ) devuelve el número de elementos copiados a la matriz de destino.
Ejemplo
El ejemplo siguiente crea una matriz a partir de los registros seleccionados de la tabla customer
y, a continuación, utiliza ACOPY( ) para crear una nueva matriz.
CLOSE DATABASES
OPEN DATABASE (HOME(2) + 'data\testdata')
USE customer && Open customer table
SELECT DISTINCT company ;
FROM customer ;
ORDER BY company ;
WHERE country = 'Germany';
INTO ARRAY gaCompanies
= ACOPY(gaCompanies, gaCompaniesTemp) && Make a copy of the array
CLEAR
DISPLAY MEMORY LIKE gaCompaniesTemp
Vea también
ADEL( ) (Función) | AELEMENT( ) (Función) | AINS( ) | ASCAN( ) (Función) | ASORT( ) (Función) | DIMENSION (Comando)