Anwendungsgebiet: String-Bearbeitung
Die Funktion EXTEND-SDF-LIST( ) fügt bei einer SDF-Liste ein neues Element hinzu. Dieses neue Element kann wiederum eine SDF-Liste sein.
Format
EXTEND-SDF-LIST( ) |
LIST = string_ausdruck ,ELEMENT = string_ausdruck ,POSITION = *LAST / *FIRST / arithm_ausdruck |
Ergebnistyp
STRING
Eingabeparameter
LIST = string_ausdruck
Bezeichnet eine SDF-Liste. Eine leere Liste muss mit '()' angegeben werden. Die Eingabe wird intern mit IS-SDF-LIST auf Gültigkeit überprüft.
ELEMENT = string_ausdruck
Bezeichnet das Element, das hinzugefügt werden soll.
POSITION =
Gibt an, wo das Element hinzugefügt werden soll.
POSITION = *LAST
Das Element wird nach der Liste hinzugefügt.
POSITION = *FIRST
Das Element wird vor der Liste hinzugefügt.
POSITION = arithm_ausdruck
Das Element wird an der angegebenen Position eingefügt.
Liegt die angegebene Position außerhalb des zulässigen Bereichs wird *LAST angenommen.
Ergebnis
Ausdruck als erweiterter String
Fehlermeldung
SDP0447 DER ANGEGEBENE STRING IST KEINE SDF-LISTE SDP0481 'POSITION' MUSS GROESSER NULL SEIN
Beispiel
A=EXTEND-SDF-LIST(LIST='(val1,val2)',ELEMENT='val3',POSITION=*last) /SHOW-VARIABLE A A = (val1,val2,val3) /A=EXTEND-SDF-LIST(LIST=A,ELEMENT='val0',POSITION=*first) /SHOW-VARIABLE A A = (val0,val1,val2,val3) /A=EXTEND-SDF-LIST(LIST=A,ELEMENT='(val4,val5)',POSITION=*last) /SHOW-VARIABLE A A = (val0,val1,val2,val3,(val4,val5))