Availability
This routine is available since katl-commons 1.0 .
Syntax:
arrayAddElement(arrayName, elem)
Description:
If elem is an element of the array type, returns a new array that includes the specified element at the end.Alias:
addElement(arrayName, elem)
Parameters:
Parameter name | Type | Required | Description |
|---|---|---|---|
arrayName | array | Yes | The array to which the new element is added |
elem | any | Yes | The element to be added. Must be the same type as the array type |
Return Type:
array
Example:
Example 1:
watchers2 = addElement(watchers, currentUser());
The result returned by the routine is assigned to a new array watchers2, so the initial array watchers will not be modified.
Example 2:
watchers = addElement(watchers, currentUser());
The result returned by the routine is assigned to the same array watchers, so the initial array watchers will be modified.
Note
If elem is not the same type as declared in the array definition, the routine returns error.
katl-commons 2.5 specific
Since 2.5 version is easier for you to just use the '+' operator to add elements to an array. array = array + element it is a simple and more meaningful way to express it. array += element is even better !
See also:
__________________________________________________________________________________________________________________________________________________