get value from list()
This function returns the value at position a (starting at 1) from the list with name b.
If the returned value is a token 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). See examples.
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.
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. Default: default . |
|
c |
Delimiter to be used to separate the subvalues in a token list. 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. Use -1 for the current iteration level. |
|
e |
(optional) Default value in case there is no other value. |
|
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
Defined is a list myList with the values {value, val1;val2}.
|
Parameter a |
Parameter b |
Parameter c |
Parameter d |
Parameter e |
Parameter f |
Result |
|
1 |
myList |
|
|
|
|
value |
|
2 |
myList |
|
|
|
|
val1;val2 |
|
2 |
myList |
; |
2 |
|
|
val2 |
|
2 |
myList |
; |
3 |
|
|
|
|
2 |
myList |
; |
3 |
somevalue |
|
somevalue |
|
1 |
myOtherList |
|
|
|
|
|
|
1 |
myOtherList |
|
|
somevalue |
|
somevalue |