Versions Compared

Key

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


Page properties
hiddentrue



Status
Tech review

Status
colourYellow
titletodoReady for review

Style guide

Status
colourYellow
titletodoReady for review

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



Page properties
hiddentrue


Short description

Returns a list with all the numbers, texts, or issues in argument l which are not in argument m. Duplicated numbers in l may appear in the output.Subtracts two number, text or issue lists from each other.

Output

Status
subtletrue
titlelist

Available since

Status
subtletrue
colourBlue
title2.1.21




Panel

Supported list types

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


Number list

UI Text Box
sizemedium
typeinfo

This function returns a number list with all the numbers in argument l which are not in argument m. Duplicated numbers in l may subtracts two number lists from each other. Duplicates won't appear in the output.

UI Text Box
typetip

If you want to avoid repetition, use the function distinct().


Code Block
languagebash
titleSyntax
linenumberstrue
except(number list llist1, number list mlist2) #Output: Number list


UI Expand
titleExamples


Parser expressionDescription


Code Block
languagebash
linenumberstrue
except([1, 2, 3, 4, 5], [2, 4])


This example returns the following number list: [1, 3, 5]


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


This example returns the following number list[1, 3]

All duplicates will be removed from the list.


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


This example returns the following number list[1, 2, 3]



UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
xxxlist1

Status
subtletrue
titledata typenumber list

Any given number listParameter description.
xxxlist2

Status
subtletrue
titledata typenumber list

Any given number listParameter description.



UI Expand
titleOutput

This function returns a

Status
subtletrue
titlenumber list
.

If the first or both lists are empty, the function returns an empty 

Status
subtletrue
titlenumber list
.



Text list

type
UI Text Box
sizemedium
typeinfo

This function

returns a text list with all strings in argument l which are not in argument m. Duplicated strings in l may

subtracts two text lists from each other. Duplicates won't appear in the output.

UI Text Box

tip
If you want to remove the output of the function except() use the function distinct().


Code Block
languagebash
titleSyntax
linenumberstrue
except(string list llist1, string list mlist2) #Output: Text list


UI Expand
titleExamples


Parser expressionDescription


Code Block
languagebash
linenumberstrue
except(["blue", "red", "green", "black"], ["red", "green", "yellow"])


This example returns the following text list["blue", "black"]


Code Block
languagebash
titleSyntax
linenumberstrue
except(fieldValue(%{00074issue.fixVersion}, subtasks()), fieldValue(%{00074issue.fixVersion}, linkedIssues()))


This example returns the text list of Fix Version/s that are in sub-tasks and not in linked issues.



UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
xxxlist1

Status
subtletrue
titledata typetext list

Any given text listParameter description.
xxxlist2

Status
subtletrue
titledata typetext list

Any given text listParameter description.



UI Expand
titleOutput

This function returns a

Status
subtletrue
titletext list
.

If the first or both lists are empty, the function returns an empty 

Status
subtletrue
titletext list
.



Issue list

UI Text Box
sizemedium
typeinfo

This function returns an issue list with all issues in argument l which are not in argument m. Duplicated issues in l may appear in output

UI Text Box
typetip
If you want to remove the output of the function except() use the function distinct()

subtracts two issue lists from each other. Duplicates won't appear in the output.


Code Block
languagebash
titleSyntax
linenumberstrue
except(issue list llist1, issue list mlist2) #Output: Issue list


UI Expand
titleExamples


Parser expressionDescription


Code Block
languagebash
linenumberstrue
except(linkedIssues(), subtasks())


This example returns an issue list of linked issues removing those which are also sub-tasks of current issue.



UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
xxxlist1

Status
subtletrue
titledata type

Parameter description.

issue list

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

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
.

If the first or both lists are empty, the function returns an empty 

Status
subtletrue
titleissue list
.