Page Comparison

Button handy

blank	true
color	#0052CC
name	Send Feedback
link	https://docs.google.com/forms/d/e/1FAIpQLScmToBe3vynAlb5fdKwCGxYqnTbDc66sIBgeecG2BuFDuHc7g/viewform?entry.2002826954=arrayAddElement+-+15480932
width	auto

Table plus

applyColStyleToCell	true
heading	0
columnTypes	s,s,s,s
multiple	false
columnAttributes	style="background:#e5e7ea;font-weight:bold,,style="background:#e5e7ea;font-weight:bold,
enableSorting	false

Syntax	arrayAddElement(arrayName, elem)	Package	array
Alias	addElement(arrayName, elem)	Pkg Usage	addElement(arrayName, elem)

Description

Excerpt

hidden	true

If elem is an element of the array type, returns a new array that includes the specified element at the end.

...

Table plus

Parameter name	Type	Required	Description
arrayName	Array	Yes	Array the new element is added to.
elem	Any	Yes	Element to be added. Must be the same type as the array type.

Array

Code Block

language	js

watchers2 = addElement(watchers, currentUser());

The result returned by the routine function is assigned to a new array watchers2, so the initial array watchers will not be modified.

Code Block

language	js

watchers = addElement(watchers, currentUser());

The result returned by the routine function 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

...

function returns error.

Info
Starting with version 2.5 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.