View Source

Short description	Returns the first element of a number, text, or issue list.
Output
Available since

Supported list types

This function returns the first element of a number list.

first(list) #Output: Number

Parser expression

Description

first([3, 2, 1, 0])

This example returns:

3

Parameters used in this function

Parameter	Input (data type)	Description
`list`		Any given number list.

This function returns a .

If the number list is empty, the function returns .

This function returns the first element of a text list.

first(list) #Output: Text

Parser expression

Description

first(["blue", "red", "green"])

This example returns:

blue

Parameters used in this function

Parameter	Input (data type)	Description
list		Any given text list.

This function returns a .

If the text list is empty, the function returns .

The function returns an issue list with the first element of the given issue list.

first(list) #Output: Issue list

Parser expression Description

first(subtasks())

This example returns the first sub-task returned by subtasks().

If subtasks() returns [SUB-1, SUB-2, SUB-3], the output will be:

[SUB-1]

Parameters used in this function

Parameter	Input (data type)	Description
`list`		Any given issue list. Usually this value is retrieved from a function (e.g. linkedIssues() or subtasks()).

This function returns an .

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