nthElement()

Supported list types

This function returns the nth element of the given number list. N specifies the position of an element in a list.

Syntax

nthElement(list, position) #Output: Number

Parser expression	Description
nthElement([5, 6, 7, 8], 3)	This example returns 7

Parameters used in this function

Parameter	Input (data type)	Description
`list`	NUMBER LIST	Any given number list.
`position`	NUMBER	A number satisfying the following condition: `1 <= position <= count(list)`

This function returns a NUMBER .

If the position is out of bounce (position <= 0 or position > count(list)), the function returns NULL.

If the number list is empty, the function returns NULL.

This function returns the nth element of the given text list.

Syntax

nthElement(list, position) #Output: Text

Parser expression	Description
nthElement(["blue", "red", "green"], 2)	This example returns `red`

Parameters used in this function

Parameter	Input (data type)	Description
`list`	TEXT LIST	Any given text list.
`position`	NUMBER	A number satisfying the following condition: `1 <= position <= count(list)`

This function returns a TEXT.

If the position is out of bounce (position <= 0 or position > count(list)), the function returns NULL.

If the text list is empty, the function returns NULL.

This function returns an issue list with the nth element of the given issue list.

Syntax

nthElement(list, position) #Output: Issue list

Parser expression	Description
nthElement(subtasks(), 2)	Returns the second issue retrieved by the function subtasks(). If an issue has the following subtasks [SUB-1, SUB-2, SUB-3], the output would be [SUB-2].

Parameters used in this function

Parameter	Input (data type)	Description
`list`	ISSUE LIST	Any given issue list. Usually this value is retrieved from a function (e.g. linkedIssues() or subtasks()).
`position`	NUMBER	A number satisfying the following condition: `1 <= position <= count(list)`

This function returns a ISSUE LIST.

If the position is out of bounce (position <= 0 or position > count(list)), the function returns an empty ISSUE LIST.

If the issue list is empty, the function returns an empty ISSUE LIST.