terraform/website/docs/language/functions/setsubtract.mdx

43 lines
1.1 KiB
Plaintext

---
page_title: setsubtract - Functions - Configuration Language
description: |-
The setsubtract function returns a new set containing the elements
from the first set that are not present in the second set
---
# `setsubtract` Function
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](https://en.wikipedia.org/wiki/Complement_\(set_theory\)#Relative_complement) of the second set.
```hcl
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`](/language/functions/setintersection) computes the _intersection_ of multiple sets
* [`setproduct`](/language/functions/setproduct) computes the _Cartesian product_ of multiple
sets.
* [`setunion`](/language/functions/setunion) computes the _union_ of
multiple sets.