Description
If elem is an element of the array type, returns a new array that includes the specified element at the end. The element is added only if it is not already in the array.
Parameters
Return Type
Array
Examples
Example 1
watchers2 = addElementIfNotExist(watchers, currentUser());
Adds currentUser to the watchers array if currentUser is not already present. The routine returns a new array watchers2, so the initial array will not be modified.
Example 2
watchers = addElementIfNotExist(watchers, currentUser());
The initial array will be modified as a result of the = operator and NOT of the routine call.
- If arrayName is not defined as an array, the routine returns error.
- If elem is not the same type as declared in the array definition, the routine returns error.
See also