add to list(unique value a, name of list b, [skip empty c])


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.