AELEMENT( )-Funktion

  • Artikel

Gibt die Nummer eines Arrayelements aus den Indizes des Elements zurück.

AELEMENT(ArrayName, nRowSubscript [, nColumnSubscript])

Rückgabewerte

Numerisch

Parameter

  • ArrayName
    Gibt den Namen des Arrays an, dessen Elementnummer Sie zurückgeben lassen möchten.

  • nRowSubscript
    Gibt den Zeilenindex an. Bei einem eindimensionalen Array gibt AELEMENT( ) auf identische Weise nRowSubscript zurück.

    Wenn Sie nur nRowSubscript einbeziehen und dieser Wert größer als die Anzahl der Zeilen im Array ist, generiert Visual FoxPro ein Fehlermeldung.

  • nColumnSubscript
    Gibt den Spaltenindex an. Bei einem zweidimensionalen Array müssen sowohl nRowSubscript als auch nColumnSubscript einbezogen werden.

Hinweise

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 werden einzelne Elementnummer verwendet. AELEMENT( ) gibt die Elementnummer zurück, wenn als Argumente die Zeilen- und Spaltenindizes eines Elements geliefert werden.

Mit den Visual FoxPro-Funktionen ADEL( ), ADIR( ), AFIELDS( ), AINS( ), ALEN( ), ASCAN( ), ASORT( ) und ASUBSCRIPT( ) können zweidimensionale Arrays bearbeitet werden. Sie setzen voraus, dass auf Elemente anhand ihrer Elementnummer Bezug genommen wird. AELEMENT( ) vereinfacht die Umwandlung von Indizes in eine Elementnummer, die dann von diesen Funktionen verwendet werden kann. Die entsprechenden Zeilen- und Spaltenindizes können mit ASUBSCRIPT( ) auch aus einer Elementnummer ermittelt werden.

Im folgenden Beispiel wird ein Array mit zwei Zeilen und drei Spalten erstellt. Mit DISPLAY MEMORY wird der Inhalt der Arrayelemente nach Elementnummer geordnet aufgelistet.

DIMENSION gaMyArray(2,3)
DISPLAY MEMORY LIKE gaMyArray
gaMyArray   Pub  A
  ( 1, 1)   L  .F. (element number 1)
  ( 1, 2)   L  .F. (element number 2)
  ( 1, 3)   L  .F. (element number 3)
  ( 2, 1)   L  .F. (element number 4)
  ( 2, 2)   L  .F. (element number 5)
  ( 2, 3)   L  .F. (element number 6)

Sie können sich auf ein Element mit Hilfe seiner Indizes oder seiner Elementnummer beziehen. Mit den Befehlen STORE 'RECHNUNG' TO gaMyArray(2, 1) und STORE 'RECHNUNG' TO gaMyArray(4) wird jeweils die Zeichenfolge RECHNUNG im gleichen Arrayelement gespeichert.

In eindimensionalen Arrays entspricht die Elementnummer dem einzeiligen Index. Daher ist es bei eindimensionalen Arrays nicht erforderlich, AELEMENT( ) zu verwenden.

Siehe auch

ADEL( ) | ADIR( ) | AFIELDS( ) | AINS( ) | ALEN( ) | ASCAN( ) | ASORT( ) | ASUBSCRIPT( ) | DIMENSION | DISPLAY MEMORY