Versions Compared

Key

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


Panel

Supported list types

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


Image AddedNumber list

UI Text Box
sizemedium
typeinfo

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

Status
subtletrue
titlenull
.


Code Block
languagebash
titleSyntax
linenumberstrue
first(numberList) #Output: Number


UI Expand
titleExamples


Parser expressionDescription


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


This example returns:

3



UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
numberList
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

Status
subtletrue
titlenumber

/text

list

Any given number list.



UI Expand
titleOutput

This function returns a

Status
subtletrue
titlenumber



Image AddedText

Panel

Supported list types

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

Image RemovedNumber

list

UI Text Box
sizemedium
typeinfo

The This function returns the first element (of a text 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 ltextList) #Output: NumberText


UI Expand
titleExamples


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

blue

Parser expressionDescription


Code Block
languagebash
linenumberstrue
first([3"blue", 2"red", 1, 0"green"])


The function This example returns the

Status
subtletrue
titlenumber



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
titlenumber text



Image Modified

Text

Issue list

UI Text Box
sizemedium
typeinfo

Returns 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
titletext
) in the text list l, or null if l is an empty list
issue list
.


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


UI Expand
titleExamples


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


Code Block
languagebash
linenumberstrue
first(["blue", "red", "green"])
The function returns the
Status
subtletrue
titletext
(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

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


The function returns a
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