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


Adds value a into the Named List with name b. The return value always is value a. If the list does not exist, it will be 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

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 contains the added value twice.