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

---
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.