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 the number 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 a list with the last subtask returned by subtasks() in it.

If subtasks() would return [SUB-1, SUB-2, SUB-3], the output would 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 .