get value from list(position a, name of list b, delimiter c, item d, [default e], [escape string f])
Gruppe |
Liefert den Wert an Position a (beginnend bei 1) aus der Named List mit dem Namen b zurück.
Falls der Rückgabewert eine durch Trennzeichen separierte Liste von Werten darstellt, kann die Rückgabe auf ein Element der Liste reduziert werden. Dabei gibt Parameter c das Listentrennzeichen und d die numerische Position (beginnend bei 1) in der Token-Liste an. Siehe Beispiele.
Gibt es keine Liste mit Namen b, ist die Liste kürzer als a oder gibt es keinen Token d, wird der Defaultwert e zurückgegeben.
Hinweis: Enthält die Liste "versteckte" Werte, werden diese als solche zurückgegeben. Siehe hierzu die Erläuterungen zum Empty Flag.
Parameterbeschreibung
Parameter |
Beschreibung |
a |
Position innerhalb der Liste (beginnend mit 1). Bei -1 wird das aktuelle Iteration Level verwendet. |
b |
Name der Liste. Default: default. |
c |
Trennzeichen in der Token-Liste, wenn ein Unterwert ermittelt werden soll. Beginnt der Wert mit 0x, wird er als hexadezimal interpretiert. |
d |
Position innerhalb der Token-Liste (beginnend mit 1). Bei -1 wird das aktuelle Iteration Level verwendet. |
e |
(optional) Defaultwert im Falle, dass kein Wert vorhanden ist. |
f |
(optional) Hier kann ein Zeichen angegeben werden, das im Rückgabewert das Trennzeichen maskiert. Kommt dieses Zeichen also im Rückgabewert vor dem in c definierten Trennzeichen vor, dann wird diese Zeichenfolge nicht als Trennzeichen interpretiert. |
Beispiele
Gegeben sei eine Liste myList mit den Werten {value, val1;val2}.
Parameter a |
Parameter b |
Parameter c |
Parameter d |
Parameter e |
Parameter f |
Ergebnis |
1 |
myList |
|
|
|
|
value |
2 |
myList |
|
|
|
|
val1;val2 |
2 |
myList |
; |
2 |
|
|
val2 |
2 |
myList |
; |
3 |
|
|
|
2 |
myList |
; |
3 |
somevalue |
|
somevalue |
1 |
myOtherList |
|
|
|
|
|
1 |
myOtherList |
|
|
somevalue |
|
somevalue |