43 lines
1.1 KiB
Plaintext
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.
|