terraform/website/docs/configuration/functions/setsubtract.html.md

layout	page_title	sidebar_current	description
language	setsubtract - Functions - Configuration Language	docs-funcs-collection-setsubtract	The setsubtract function returns a new set containing the elements from the first set that are not present in the second set

setsubtract Function

-> Note: This page is about Terraform 0.12 and later. For Terraform 0.11 and earlier, see 0.11 Configuration Language: Interpolation Syntax.

The setsubtract function returns a new set containing the elements from the first set that are not present in the second set. In other words, it computes the relative complement of the first set in the second set.

setsubtract(a, b)

Examples

> setsubtract(["a", "b", "c"], ["a", "c"])
[
  "b",
]

Set Difference (Symmetric Difference)

> setunion(setsubtract(["a", "b", "c"], ["a", "c", "d"]), setsubtract(["a", "c", "d"], ["a", "b", "c"]))
[
  "b",
  "d",
]

Related Functions

• setintersection computes the intersection of multiple sets
• setproduct computes the Cartesian product of multiple sets.
• setunion computes the union of multiple sets.