mirror of
https://github.com/opentffoundation/opentf.git
synced 2025-12-20 02:09:26 -05:00
Signed-off-by: Janos <86970079+janosdebugs@users.noreply.github.com> Signed-off-by: Damian Stasik <920747+damianstasik@users.noreply.github.com> Signed-off-by: Roman Grinovski <roman.grinovski@gmail.com> Co-authored-by: Damian Stasik <920747+damianstasik@users.noreply.github.com> Co-authored-by: Roman Grinovski <roman.grinovski@gmail.com>
40 lines
1.2 KiB
Plaintext
40 lines
1.2 KiB
Plaintext
---
|
|
sidebar_label: setintersection
|
|
description: |-
|
|
The setintersection function takes multiple sets and produces a single set
|
|
containing only the elements that all of the given sets have in common.
|
|
---
|
|
|
|
# `setintersection` Function
|
|
|
|
The `setintersection` function takes multiple sets and produces a single set
|
|
containing only the elements that all of the given sets have in common.
|
|
In other words, it computes the
|
|
[intersection](https://en.wikipedia.org/wiki/Intersection_\(set_theory\)) of the sets.
|
|
|
|
```hcl
|
|
setintersection(sets...)
|
|
```
|
|
|
|
## Examples
|
|
|
|
```
|
|
> setintersection(["a", "b"], ["b", "c"], ["b", "d"])
|
|
[
|
|
"b",
|
|
]
|
|
```
|
|
|
|
The given arguments are converted to sets, so the result is also a set and
|
|
the ordering of the given elements is not preserved.
|
|
|
|
## Related Functions
|
|
|
|
* [`contains`](../../language/functions/contains.mdx) tests whether a given list or set contains
|
|
a given element value.
|
|
* [`setproduct`](../../language/functions/setproduct.mdx) computes the _Cartesian product_ of multiple
|
|
sets.
|
|
* [`setsubtract`](../../language/functions/setsubtract.mdx) computes the _relative complement_ of two sets
|
|
* [`setunion`](../../language/functions/setunion.mdx) computes the _union_ of
|
|
multiple sets.
|