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

Group

Basic Functions


Returns the value of key a (starting at 1) from the Named Map with name b. If no name is specified default is used.

If the returned value is a list of values separated by a delimiter, one of these values can be returned by specifying the delimiter in c and the position to be returned in d (starting with 1). If parameter d has the value -1, the iteration level is used instead. If there is no map with name b or no key a or no token d, the default value e is returned.

Hint: If the list contains 'hidden' values, they will be returned. See the explanations for the Empty Flag.

Hint: 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. The value will be interpreted as hexadecimal value if it starts with 0x.

d

(optional) Number of the element in the token list to be returned (starting at 1). If parameter d has the value -1, the iteration level is used instead.

e

(optional) Default value if there is no value to be returned.


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

Result

key1

MyMap




Value

key2

MyMap




val1;val2

key2

MyMap

;

2


val2

key2

MyMap

;

3



key2

MyMap

;

3

someval

someval

key

MyMap





key

MyMap



someval

someval

key1

MyOtherMap