get value from map(key a, name of map b, delimiter c, item d, [default e], [escape string f])

Gruppe

Basic Functions


Liefert den Wert zu Schlüssel a aus der Named Map 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 in der Token-Liste, mit 1 beginnend, an. Siehe Beispiele.

Gibt es keine Map mit Namen b, befindet sich in der Map kein Schlüssel a oder gibt es keinen Token d, wird der Defaultwert e zurückgegeben.

Hinweis: Enthält die Map "versteckte" Werte, werden diese als solche zurückgegeben. Siehe hierzu die Erläuterungen zum Empty Flag.

Hinweis: Falls es sich um eine Map für Vererbungswerte handelt, wird als Ergebnis nur der gerade sichtbare Wert zurückgegeben.


Parameterbeschreibung


Parameter

Beschreibung

a

Schlüsselwert.

b

Name der Map.

c

(optional) Trennzeichen innerhalb des Rückgabe-Wertes. Der Wert wird als hexadezimal interpretiert, wenn er mit 0x beginnt.

d

(optional) Position innerhalb des Rückgabe-Wertes (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 Map myMap mit den Werten {key1=value, key2=val1;val2}.


Parameter a

Parameter b

Parameter c

Parameter d

Parameter e

Parameter f

Ergebnis

key1

myMap





value

key2

myMap





val1;val2

key2

myMap

;

2



val2

key2

myMap

;

3




key2

myMap

;

3

somevalue

somevalue

key

myMap






key

myMap



somevalue

somevalue

key1

myOtherMap