ACOPY( )-Funktion

Kopiert Elemente von einem Array in ein anderes.

ACOPY(SourceArrayName, DestinationArrayName    
[, nFirstSourceElement [, nNumberElements [, nFirstDestElement ]]])

Rückgabewerte

Numerisch

Parameter

• SourceArrayName, DestinationArrayName
  Gibt das Quellarray SourceArrayName an, von dem aus Elemente als 1:1-Kopie in das Zielarray DestinationArrayName kopiert werden. Die Elemente des Quellarrays ersetzen hierbei die Elemente im Zielarray.

  Die Arrays können ein- oder zweidimensional sein. Ist das Zielarray nicht vorhanden, wird es von Visual FoxPro automatisch erstellt. In einem solchen Fall entspricht die Größe des Zielarrays der des Quellarrays.

  Anmerkung   Auf ein Element eines zweidimensionalen Arrays können Sie auf zwei Arten Bezug nehmen. Im ersten Fall dienen zwei Indizes dazu, die Zeilen- und die Spaltenposition des jeweiligen Elements im Array anzugeben, bei der zweiten Möglichkeit wird mit der einzelnen Elementnummer gearbeitet. Diese Funktion benötigt ebenso wie andere Funktionen, mit denen zweidimensionale Arrays bearbeitet werden, Einzelelementnummern (hier nFirstSourceElement und nFirstDestElement). Mit AELEMENT( ) können Sie für ein Element eines zweidimensionalen Arrays anhand des Zeilen- und des Spaltenindexes ermitteln, welche Nummer das Element hat.

• nFirstSourceElement
  Gibt für das Quellarray die Nummer des ersten zu kopierenden Elements an und ist inklusiv (d. h. die Elementnummer nFirstSourceElement ist Bestandteil des Kopiervorgangs). Ist nFirstSourceElement nicht angegeben, erfolgt der Kopiervorgang ab dem ersten Element des Quellarrays.

• nNumberElements
  Gibt an, wie viele Elemente des Quellarrays kopiert werden sollen. Ist nNumberElements gleich -1, werden ab dem Element nFirstSourceElement alle weiteren Elemente des Quellarrays kopiert.

• nFirstDestElement
  Gibt für das Zielarray das erste Element an, das bei einem Kopiervorgang ersetzt werden soll.

Hinweise

ACOPY( ) gibt als Rückgabewert die Anzahl der in das Zielarray kopierten Elemente zurück.

Beispiel

Im folgenden Beispiel wird ein Array aus ausgewählten Datensätzen der Tabelle customer erstellt und anschließend mit Hilfe von ACOPY( ) ein neues Array erstellt.

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

Siehe auch

ADEL( )-Funktion | AELEMENT( )-Funktion | AINS( )-Funktion | ASCAN( )-Funktion | ASORT( )-Funktion | DIMENSION-Befehl