resilien
/
terraform
2
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
terraform/website/docs/language/functions/setunion.mdx

43 lines
1.1 KiB
Plaintext
Raw Normal View History

lang/functions: set functions from cty 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.
2019-01-15 20:51:21 +01:00
---
migrate docs to mdx
2021-12-15 03:41:17 +01:00
page_title: setunion - Functions - Configuration Language
lang/functions: set functions from cty 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.
2019-01-15 20:51:21 +01:00
description: |-
The setunion function takes multiple sets and produces a single set
containing the elements from all of the given sets.
---
# `setunion` Function
The `setunion` function takes multiple sets and produces a single set
containing the elements from all of the given sets. In other words, it
migrate docs to mdx
2021-12-15 03:41:17 +01:00
computes the [union](https://en.wikipedia.org/wiki/Union_\(set_theory\)) of
lang/functions: set functions from cty 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.
2019-01-15 20:51:21 +01:00
the sets.
```hcl
setunion(sets...)
```
## Examples
```
> setunion(["a", "b"], ["b", "c"], ["d"])
[
"d",
"b",
"c",
"a",
]
```
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
migrate docs to mdx
2021-12-15 03:41:17 +01:00
* [`contains`](/language/functions/contains) tests whether a given list or set contains
lang/functions: set functions from cty 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.
2019-01-15 20:51:21 +01:00
a given element value.
migrate docs to mdx
2021-12-15 03:41:17 +01:00
* [`setintersection`](/language/functions/setintersection) computes the _intersection_ of
lang/functions: set functions from cty 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.
2019-01-15 20:51:21 +01:00
multiple sets.
migrate docs to mdx
2021-12-15 03:41:17 +01:00
* [`setproduct`](/language/functions/setproduct) computes the _Cartesian product_ of multiple
lang/functions: set functions from cty 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.
2019-01-15 20:51:21 +01:00
sets.
migrate docs to mdx
2021-12-15 03:41:17 +01:00
* [`setsubtract`](/language/functions/setsubtract) computes the _relative complement_ of two sets