get value from list(position a, name of list b, delimiter c, item d, [default e])
|
Group |
Returns the value at position a (starting at 1) from the named 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.
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. 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. |
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 |
somevalue |
somevalue |
|
1 |
myOtherList |
|
|
|
|
|
1 |
myOtherList |
|
|
somevalue |
somevalue |