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


Returns the value at position a (starting at 1) from the named list 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 with c and the position to be returned with d (starting with 1).

If there is no list with name b or the list is shorter than a or there is 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.

Description of Parameters

Parameter

Description

a

Position of the value in the list, starting with 1 (use -1 for the current iteration level).

b

Name of the list.

c

Delimiter to be used to separate the values. If the value starts with 0x, it will be interpreted as a hexadecimal value.

d

Number of the element in the token list to be returned.

e

(optional) Default value in case there is no other value.

Examples

Defined is a list MyList with the values {Value, val1;val2}.

Parameter a

Parameter b

Parameter c

Parameter d

Parameter e

Result

1

MyList

Value

2

MyList

val1;val2

2

MyList

;

2

val2

2

MyList

;

3

2

MyList

;

3

someval

someval

1

MyOtherList

1

MyOtherList

someval

someval