first()

Supported list types

This function returns the first element of a number list.

Syntax

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`	NUMBER LIST	Any given number list.

This function returns a NUMBER .

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

This function returns the first element of a text list.

Syntax

first(list) #Output: Text

Parser expression	Description
%{first(["blue", "red", "green"])}	This example returns: blue
%{first(%{issue.components})}	This exmaple returns the first component in which this issue is involved.

Parameters used in this function

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

This function returns a TEXT.

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

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

Syntax

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`	ISSUE LIST	Any given issue list. Usually this value is retrieved from a function (e.g. linkedIssues() or subtasks()).

This function returns an ISSUE LIST.

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