Supported list types

Number list

This function returns the nth element of the given number list. N specifies the position of an element in a list. If the position is out of bounds (position <= 0 or position > count(list)), the function returns NULL. If the number list is empty, the function returns NULL.

Syntax
nthElement(numberList, position) #Output: Number
Examples
Parser expressionDescription
nthElement([5, 6, 7, 8], 3) 

This example returns:

7

Additional information

Parameters used in this function

ParameterInput (data type)Description
numberList

NUMBER LIST

Any given number list.
position

NUMBER

A number satisfying the following condition: 1 <= position <= count(list)
Output

This function returns a NUMBER


Text list

This function returns the nth element of the given text list. If the position is out of bounds (position <= 0 or position > count(list)), the function returns NULL. If the text list is empty, the function returns NULL.

Syntax
nthElement(textList, position) #Output: Text
Examples
Parser expressionDescription
nthElement(["blue", "red", "green"], 2)

This example returns:

red

Additional information

Parameters used in this function

ParameterInput (data type)Description
textList

TEXT LIST

Any given text list.
position

NUMBER

A number satisfying the following condition: 1 <= position <= count(list)
Output

This function returns a TEXT


Issue list

This function returns an issue list with the nth element of the given issue list. If the position is out of bounds (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.

Syntax
nthElement(issueList, position) #Output: Issue list
Examples
Parser expressionDescription
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].

Additional information

Parameters used in this function

ParameterInput (data type)Description
issueList

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)
Output

This function returns a ISSUE LIST


Use cases and examples