Anwendungsgebiet: Variablenzugriff (Variablenname)
Mit der Funktion NEXT-VARIABLE-NAME( ) lässt sich der Aufbau von zusammengesetzten Variablen analysieren, vor allem in Verbindung mit der Funktion FIRST-VARIABLE-
NAME( ).
Die Funktion NEXT-VARIABLE-NAME( ) liefert den Namen des in der gleichen Ebene folgenden Variablenelements. Wenn es kein Folgeelement auf dieser Ebene mehr gibt, liefert NEXT-VARIABLE-NAME( ) als Ergebnis *END.
Format
NEXT-VARIABLE-NAME( ) NEXT-VAR-NAME( ) |
VARIABLE-NAME = string_ausdruck |
Ergebnistyp
STRING
Eingabeparameter
VARIABLE-NAME = string_ausdruck
Bezeichnet eine Variable.
Bezeichnet VARIABLE-NAME eine Liste, wird *END oder der entsprechende Elementname ausgegeben.
Bezeichnet VARIABLE-NAME ein Listenelement (liste#i), wird der Name des folgenden Elements ausgegeben (liste#i+1), sofern dieses existiert. Existiert kein Listenelement liste#i+1, wird *END ausgegeben. Der Variablenname muss in Hochkommata eingeschlossen werden, wenn man ihn direkt (als Literal) angeben will (siehe dazu das folgende Beispiel sowie das Beispiele bei IS-DECLARED( ) ).
Ergebnis
Name des Elements, das in der zusammengesetzten Variablen auf der gleichen Ebene auf „string_ausdruck“ folgt.
*END
„string_ausdruck“ war das letzte Element der Ebene.
Fehlermeldung
SDP1101 SYNTAX-FEHLER IM VARIABLEN-NAMEN
Beispiel 1
Eine zusammengesetzte Variable AR enthält folgende Elemente.
AR#1 AR#2 AR#3 /A = NEXT-VARIABLE-NAME(VARIABLE-NAME = 'AR#1') /SHOW-VARIABLE A A = AR#2 /A=NEXT-VARIABLE-NAME(VARIABLE-NAME = 'AR#3') /SHOW-VARIABLE A A = *END
Wenn NEXT-VARIABLE-NAME( ) auf AR#1 angewendet wird, wird als Ergebnis
AR#2 geliefert, der Name des auf AR#1 folgenden Elements.
AR#3 ist das letzte Element des Arrays, NEXT-VARIABLE-NAME( ) liefert also *END.
Beispiel 2
Eine zusammengesetzte Variable ARR enthält folgende Elemente:
ARR#1
ARR#22
ARR#30
/A = NEXT-VAR-NAME('ARR#1')
/SHOW-VARIABLE A
A = ARR#22