Anwendungsgebiet: Variablenzugriff (Variablenname)
Die Funktion ARRAY-INDEX( ) lässt sich auf Arrays anwenden. ARRAY-INDEX liefert den Wert eines Arrayindex. Dadurch können andere Funktionen anschließend über den Arrayindex explizit auf dieses Element zugreifen.
Format
ARRAY-INDEX( ) |
ARRAY-NAME = string_ausdruck ,INDEX = *FIRST / *LAST / *LOWER-BOUND / *UPPER-BOUND |
Ergebnistyp
INTEGER
Eingabeparameter
ARRAY-NAME = string_ausdruck
Bezeichnet einen Array.
INDEX =
Gibt an, welcher Arrayindex abgefragt wird.
INDEX = *FIRST
Arrayindex des ersten Elements des Arrays, das einen gültigen Wert enthält.
INDEX = *LAST
Arrayindex des letzten Elements des Arrays, das einen gültigen Wert enthält.
INDEX = *LOWER-BOUND
Arrayindex, der bei der Variablendeklaration mit dem Kommando DECLARE-VARIABLE im Operanden MULTIPLE-ELEMENTS = *ARRAY (LOWER-BOUND = ) festgelegt ist.
INDEX = *UPPER-BOUND
Arrayindex, der bei der Variablendeklaration mit dem Kommando DECLARE-VARIABLE im Operanden MULTIPLE-ELEMENTS = *ARRAY (UPPER-BOUND = ) festgelegt ist.
Ergebnis
Index des Arrayelements, wird als Integer-Wert zurückgegeben.
Fehlermeldungen
SDP0423 VARIABLE '(&00)' KEIN ARRAY SDP1007 NOCH KEINE VARIABLE ANGELEGT SDP1052 AGGREGATELEMENT NICHT VORHANDEN SDP1101 SYNTAX-FEHLER IM VARIABLEN-NAMEN
Beispiel
Der Array AR wird deklariert und erhält folgenden Inhalt:
/DECLARE-VARIABLE AR,TYPE = *STRING, MULTIPLE-ELEMENTS = *ARRAY
/AR#2 = 'abc'
/AR#3 = 'cde'
/AR#4 = ' '
/ARIND = ARRAY-INDEX('AR', *FIRST)
/SHOW-VARIABLE ARIND
ARIND = 2
/ARIND = ARRAY-INDEX('AR', *LAST)
/SHOW-VARIABLE ARIND
ARIND = 4
/ARIND = ARRAY-INDEX('AR', *LOWER-BOUND)
/SHOW-VARIABLE ARIND
ARIND = 0
/ARIND = ARRAY-INDEX('AR', *UPPER-BOUND)
/SHOW-VARIABLE ARIND
ARIND = 2147483647