PhixFlow Help

addElement


Function: addElement()

Adds a value to the end of a list and returns the list.

Syntax

addElement(list, value)

ArgumentTypeDescription
listAnyThe list to which value should be added. If this argument is a variable which evaluates to null then a new list will be returned containing only value. If this argument is not a list but a single value then a new list will be returned containing this argument and value.
valueAnyThe item that should be added to list

Examples

addElement($list, $value)

Adds $value as a new entry at the end of $list, and returns the list. If the list provided is empty (that is $list is the value _NULL ), the list returned will contain a single value $value.

forEach($name, in.name, if ($name != _NULL, addElement($usableNames, $name) ) )

Using the forEach function we go through every name provided in the variable in.name. We want to get a list of all the names which are not null, so for each one we test the value using the condition $name != _NULL. If the name is not null, we add it to a list called $usableNames using addElement.

ifNull(in.rate, addElement($errors,"Missing rate value"))

If in.rate is not found then an error message is added to a list of errors found so far. This is a useful way of building up a list of problems which are found as a stream is processed, which can then be formatted into a list of errors recorded on a Stream.

See Also

Please let us know if we could improve this page feedback@phixflow.com