Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Page properties
hiddentrue
Status
Tech review

Status
titletodo

Style guide

Status
titletodo

Status
titletodo
Status
colourYellow
titleReady for review
Status
colourGreen
titledone
Status
colourRed
titleflagged

Page properties
hiddentrue
Short descriptionReturns the first element ( Statussubtletruetitlenumber/text) in the number/text list l, or  null if l is an empty list.Output Statussubtletruetitlenumber/text Panel

Supported list types

Table of Contents
exclude(Supported list types).*
stylecircle
typeflat
separatorpipe


Number list

UI Text Box
sizemedium
typeinfo

The This function returns the first element (of a number list. If the list is empty, the function returns

Status
subtletrue
titlenumber
) in the number list l, or  null if l is an empty list
null
.


Code Block
languagebash
titleSyntax
linenumberstrue
first(number list lnumberList) #Output: Number


UI Expand
titleExamples


3, which is the first element of the number list l.

Parser expressionDescription


Code Block
languagebash
linenumberstrue
first([3, 2, 1, 0])


This example returns:

3The function returns the

Status
subtletrue
titlenumber



UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
<parameter>numberList

Status
subtletrue
titledata typenumber list

Any given number listParameter description.



UI Expand
titleOutput

The This function returns a

Status
subtletrue
titlenumber



Text list

UI Text Box
sizemedium
typeinfo

Returns This function returns the first element (of a text list. If the list is empty, the function returns

Status
subtletrue
titletext
) in the text list l, or null if l is an empty list
null
.


Code Block
languagebash
titleSyntax
linenumberstrue
first(string list ltextList) #Output: Text


UI Expand
titleExamples


"blue", which is the first element of the text list l.

Parser expressionDescription


Code Block
languagebash
linenumberstrue
first(["blue", "red", "green"])


This example returns:

blueThe function returns the

Status
subtletrue
titletext



UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
<parameter>textList

Status
subtletrue
titledata typetext list

Any given text listParameter description.



UI Expand
titleOutput

The This function returns a

Status
subtletrue
titletext



Issue list

UI Text Box
sizemedium
typeinfo

The function returns an issue list with the first element of the given issue list. If the issue list is empty, the function returns an empty 

Status
subtletrue
titleissue list
with the first element in issue list l, or an empty list if l is an empty list.


Code Block
languagebash
titleSyntax
linenumberstrue
first(issue list lissueList) #Output: Issue list


UI Expand
titleExamples


Parser expressionDescription


Code Block
languagebash
linenumberstrue
first(subtasks())


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

UI Text Box
typeinfo

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

[SUB-1]




UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
<parameter>issueList

Status
subtletrue
titledata typeissue list

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



UI Expand
titleOutput

The This function returns an

Status
subtletrue
titleissue list



Image AddedUse cases and examples

Page properties report
firstcolumnUse case
headingsJWT feature, Workflow function, Field type, Automated action, Parser functions
cqllabel = "parser_func_first" and space = currentSpace()


Page properties
hiddentrue
id1


Parser function cloudfirst()
Map(tick)
Notes




Page properties
hiddentrue



Status
Tech review

Status
colourGreen
titledone

Style guide

Status
colourGreen
titledone

Status
titletodo
Status
colourYellow
titleReady for review
Status
colourGreen
titledone
Status
colourRed
titleflagged



Page properties
hiddentrue


Short description

Returns the first element of a number, text, or issue list.

Output

Status
subtletrue
titlenumber
 
Status
subtletrue
titletext
 
Status
subtletrue
titleissue list

Available since

Status
subtletrue
colourBlue
title2.1.26

Label

Status
colourRed
titlestaff pick