Supported list types


Number list

This function returns a number list of elements in a list which are not present in a second list.

The returned list does not contain duplicates. The order is respected.


except(numberList1, numberList2) #Output: Number list



Parser expressionDescription


except([1, 2, 3, 4, 5], [2, 4])


This example returns

[1, 3, 5]


except([1, 1, 2, 3, 3], [2])


This example returns

[1, 3]

All duplicates will be removed from the list.


except([1, 1, 2, 3, 3], [])


This example returns

[1, 2, 3]



Parameters used in this function

ParameterInput (data type)Description
numeberList1

Any given number list.
lnumberList2

Any given number list.



This function returns a .

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



Text list

Variant for text lists.


except(textList1, textList2) #Output: Text list



Parser expressionDescription


except(["blue", "red", "green", "black"], ["red", "green", "yellow"])


This example returns

["blue", "black"]


except(fieldValue(%{issue.fixVersion}, subtasks()), fieldValue(%{issue.fixVersion}, linkedIssues()))


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

To achieve this, the following functions are used:



Parameters used in this function

ParameterInput (data type)Description
textList1

Any given text list.
textList2

Any given text list.



This function returns a .

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



Issue list

Variant for issue lists.


except(issueList1, issueList2) #Output: Issue list



Parser expressionDescription


except(linkedIssues(), subtasks())


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

To achieve this, the following functions are used:



Parameters used in this function

ParameterInput (data type)Description
issueList1

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

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



This function returns an .

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


This function is the equivalent to the list operator EXCEPT and can be used interchangeably. 



Use cases and examples



Parser function cloudexcept()
Map(tick)
Notes






Status
Tech review

Style guide




Short description

Removes certain elements from a list.

Output

Available since

Label