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

Group

Basic Functions


Returns the value of key a from the Named 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.

Description of 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