Status
Tech review

Style guide




Short description

Subtracts two number, text or issue lists from each other.

Output

Available since




Supported list types


Number list

This function subtracts two number lists from each other. Duplicates won't appear in the output.


except(list1, list2) #Output: Number list



Parser expressionDescription


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


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


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


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

All duplicates will be removed from the list.


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


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



Parameters used in this function

ParameterInput (data type)Description
list1

Any given number list.
list2

Any given number list.



This function returns a .

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



Text list

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


except(list1, list2) #Output: Text list



Parser expressionDescription


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


This example returns the following text list["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.



Parameters used in this function

ParameterInput (data type)Description
list1

Any given text list.
list2

Any given text list.



This function returns a .

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



Issue list

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


except(list1, list2) #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.



Parameters used in this function

ParameterInput (data type)Description
list1

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

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 .