Liefert den Wert zu Schlüssel a aus der Map mit dem Namen b zurück.
Der Rückgabewert kann eine durch Trennzeichen separierte Liste von Werten darstellen. In diesem Fall reduziert Parameter c die Rückgabe auf ein Element der Liste. Parameter c definiert dabei das Listentrennzeichen. Parameter d definiert die numerische Position in der Token-Liste, beginnend mit 1. Siehe Beispiele.
Der Rückgabewert ist der Defaultwert e in folgenden Fällen: Es gibt keine Map mit Namen b. Oder die Map enthält keinen Schlüssel a. Oder es gibt keinen Token d.
HINWEIS: Enthält die Map "versteckte" Werte, gibt die Funktion diese als solche zurück. Siehe hierzu die Erläuterungen zum Empty Flag.
HINWEIS: Handelt es sich um eine Map für Vererbungswerte, gibt die Funktion nur den gerade sichtbaren Wert zurück.
HINWEIS: Existiert die Map b noch nicht, legt die Funktion sie automatisch leer an. Details dazu finden Sie unter Tokenliste, Liste, Map.
Parameter
Parameter | Beschreibung |
|---|---|
a | Schlüsselwert. |
b | Name der Map. |
c | (optional) Trennzeichen innerhalb des Rückgabewertes. Die Funktion interpretiert den Wert als hexadezimal, wenn er mit 0x beginnt. |
d | (optional) Position innerhalb des Rückgabewertes (beginnend mit 1). Bei -1 verwendet die Funktion das aktuelle Iteration Level. |
e | (optional) Defaultwert im Falle, dass kein Wert vorhanden ist. |
f | (optional) Zeichen, das im Rückgabewert das Trennzeichen maskiert. Steht dieses Zeichen im Rückgabewert vor dem in c definierten Trennzeichen, interpretiert die Funktion diese Zeichenfolge nicht als Trennzeichen. |
Beispiele
Gegeben sei eine Map myMap mit den Werten {key1=value, key2=val1;val2, key3=Main St\; Suite 5;Second Line}.
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 | |||||
key3 | myMap | ; | 1 | Main St\ | ||
key3 | myMap | ; | 1 | \ | Main St\; Suite 5 | |
key3 | myMap | ; | 2 | \ | Second Line |