Skip to main content

List.Difference

Returns the difference of the two given lists.

Syntax

List.Difference(
list1 as list,
list2 as list,
optional equationCriteria as any
) as list

Remarks

Returns the items in list list1 that do not appear in list list2. Duplicate values are supported. An optional equation criteria value, equationCriteria, can be specified to control equality testing.

Examples

Example #1

Find the items in list {1, 2, 3, 4, 5} that do not appear in {4, 5, 3}.

List.Difference({1, 2, 3, 4, 5}, {4, 5, 3})

Result:

{1, 2}

Example #2

Find the items in the list {1, 2} that do not appear in {1, 2, 3}.

List.Difference({1, 2}, {1, 2, 3})

Result:

{}

Category

List.Set operations