get value from map()
Liefert den Wert zu Schlüssel a aus der 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.
Parameter
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 |
|
|
|
|
|