get value from map()
This function returns the value of key a from the map with name b.
If the returned value is a list of values separated by a delimiter (token list), one of these values can be returned by specifying the delimiter in c and the position to be returned in d (starting with 1). See examples.
If there is no map with name b or no key a or no token d, the default value e is returned.
Note: If the list contains 'hidden' values, they will be returned. See the explanations for the Empty Flag.
Note: If the map is a map with Inheritance Values, only the currently visible value is returned.
Parameters
|
Parameter |
Description |
|
a |
Key value. |
|
b |
Name of the map. |
|
c |
(optional) Delimiter to be used to separate the values in a token list. The value will be interpreted as hexadecimal value if it starts with 0x. |
|
d |
(optional) Position of the element in the token list to be returned (starting at 1). Use -1 for the current iteration level. |
|
e |
(optional) Default value to be returned if no other value was found. |
|
f |
(optional) Here you can specify a character that masks the delimiter in the return value. So if this character occurs in the return value before the delimiter defined in c, this character sequence will not be interpreted as a delimiter. |
Examples
Assume we have a map myMap with the values {key1=value, key2=val1;val2}.
|
Parameter a |
Parameter b |
Parameter c |
Parameter d |
Parameter e |
Parameter f |
Result |
|
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 |
|
|
|
|
|