terraform/website/docs/configuration/functions/setunion.html.md

1.3 KiB

layout page_title sidebar_current description
language 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

-> Note: This page is about Terraform 0.12 and later. For Terraform 0.11 and earlier, see 0.11 Configuration Language: Interpolation Syntax.

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.

  • contains tests whether a given list or set contains a given element value.
  • setintersection computes the intersection of multiple sets.
  • setproduct computes the Cartesian product of multiple sets.
  • setsubtract computes the relative complement of two sets