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 . If the number list is empty, the function returns .


nthElement(numberList, position) #Output: Number



Parser expressionDescription


nthElement([5, 6, 7, 8], 3)


This example returns:

7



Parameters used in this function

ParameterInput (data type)Description
numberList

Any given number list.
position

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



This function returns a



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 . If the text list is empty, the function returns .


nthElement(textList, position) #Output: Text



Parser expressionDescription


nthElement(["blue", "red", "green"], 2)


This example returns:

red



Parameters used in this function

ParameterInput (data type)Description
textList

Any given text list.
position

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



This function returns a



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 . If the issue list is empty, the function returns an empty .


nthElement(issueList, position) #Output: Issue list



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




Parameters used in this function

ParameterInput (data type)Description
issueList

Any given issue list. Usually this value is retrieved from a function (e.g. linkedIssues() or subtasks()).
position

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



This function returns a



Use cases and examples



Parser function cloudnthElement()
Map(tick)
Notes






Status
Tech review

Style guide




Short description

Returns the nth element of a number, string or issue list.

Output

 

Available since

Label