add to list(unique value a, name of list b, [skip empty c])
Group |
Inserts the value a into the named list b, but only if it is not yet included.
The return value always is value a. If the list does not exist, it is created. If the list name is not explicitly specified, then the list is used with the name default.
If the value to be added a has the Empty Flag set and parameter c has the value true, a will not be added to the list.
Description of Parameters
Parameter |
Description |
a |
Unique value to be added. |
b |
Name of list. |
c |
(optional) true, if values with set Empty Flag should not be added to the list. Default: false. |
Example
Parameter a |
Parameter b |
Parameter c |
Result |
Value Added to List |
Hallo (Empty Flag: false) |
MyList |
Hallo |
Yes. |
|
Hello (Empty Flag: true) |
MyList |
false |
Hello |
Yes. |
Hällo (Empty Flag: true) |
MyList |
true |
Hällo |
No. |
Hint: After the call of the function, the list MyList contains the added value. After another call with the same value, the list still contains only this one value.