Files
opentf/website/docs/configuration/functions/setunion.html.md
Martin Atkins da51e72cbb 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-16 09:57:16 -08:00

1.1 KiB

layout, page_title, sidebar_current, description
layout page_title sidebar_current description
functions setunion - Functions - Configuration Language docs-funcs-collection-setunion 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 computes the union of the sets.

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.

  • sethaselement tests whether a given set contains a given element value.
  • setintersection computes the intersection of multiple sets.
  • setproduct computes the cartesian product of multiple sets.