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)