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 |