Page Comparison

Warning
Looking for the documentation on the newest versions of SIL Engine and the Simple Issue Language for Jira 8 for Server/Data Center? Click here !

Info

title	Availability

This routine is available since katl-commons starting with SIL Engine™ 1.0.

...

Syntax

...

arrayAddElementIfNotExist(arrayName, elem)

Description

...

Excerpt
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.

Alias

...

addElementIfNotExist(arrayName, elem)

Parameters

...

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

Return Type

...

array

Example

...

example 1

...

Code Block
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

...

Code Block
watchers = addElementIfNotExist(watchers, currentUser());

The initial array will be modified as a result of the = operator and NOT of the routine call.

Notes

...

Note
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.

Filter by label (Content by label)
showLabels false
max 100
showSpace labels false
cql label = "array_routines"
labels
_________________________________________________________________________________________________________________________________
array_routines

Versions Compared

Old Version 1

New Version Current

Key

Syntax

arrayAddElementIfNotExist(arrayName, elem)

Description

Excerpt
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.

Alias

addElementIfNotExist(arrayName, elem)

Parameters

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

Return Type

array

Example

example 1

Code Block
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

Code Block
watchers = addElementIfNotExist(watchers, currentUser());
The initial array will be modified as a result of the = operator and NOT of the routine call.

Notes

Note
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

Filter by label (Content by label)
showLabels false
max 100
showSpace labels false
cql label = "array_routines"
labels
_________________________________________________________________________________________________________________________________
array_routines

Page Comparison

Versions Compared

Old Version 1

New Version Current

Key

Syntax

arrayAddElementIfNotExist(arrayName, elem)

Description

ExcerptIf 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.

Alias

addElementIfNotExist(arrayName, elem)

Parameters

Parameter nameTypeRequiredDescriptionarrayNamearrayYesThe array to which Array the new element is added to.elemanyYesThe element Element to be added. Must be the same type as the array type.

Return Type

array

Example

example 1

Code Blockwatchers2 = 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

Code Blockwatchers = addElementIfNotExist(watchers, currentUser()); The initial array will be modified as a result of the = operator and NOT of the routine call.

Notes

NoteIf 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

Filter by label (Content by label)showLabelsfalsemax100showSpacelabelsfalsecqllabel = "array_routines"labels_________________________________________________________________________________________________________________________________array_routines

Excerpt
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.

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

Code Block
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.

Code Block
watchers = addElementIfNotExist(watchers, currentUser());
The initial array will be modified as a result of the = operator and NOT of the routine call.

Note
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.

Filter by label (Content by label)
showLabels false
max 100
showSpace labels false
cql label = "array_routines"
labels
_________________________________________________________________________________________________________________________________
array_routines