mirror of
https://github.com/opentffoundation/opentf.git
synced 2026-05-29 13:02:26 -04:00
da51e72cbb
The sethaselement, setintersection, and setunion functions are defined in the cty stdlib. Making them available in Terraform will make it easier to work with sets, and complement the currently-Terraform-specific setproduct function. In the long run setproduct should probably move into the cty stdlib too, but since it was submitted as a Terraform function originally we'll leave it here now for simplicity's sake and reorganize later.
41 lines
1.1 KiB
Markdown
41 lines
1.1 KiB
Markdown
---
|
|
layout: "functions"
|
|
page_title: "setintersection - Functions - Configuration Language"
|
|
sidebar_current: "docs-funcs-collection-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
|
|
|
|
* [`sethaselement`](./sethaselement.html) tests whether a given set contains
|
|
a given element value.
|
|
* [`setproduct`](./setproduct.html) computes the _cartesian product_ of multiple
|
|
sets.
|
|
* [`setunion`](./setunion.html) computes the _union_ of
|
|
multiple sets.
|