Files
opentf/website/docs/configuration/functions/coalescelist.html.md
Nick Fagerlund 596e529602 website: Adopt a ton of pages into the "language" layout
As of this commit, that layout doesn't exist yet, but I'm isolating the one-line
changes to their own commit to try and keep your eyes from glazing over.
2020-10-26 18:19:26 -07:00

1.0 KiB

layout, page_title, sidebar_current, description
layout page_title sidebar_current description
language coalescelist - Functions - Configuration Language docs-funcs-collection-coalescelist The coalescelist function takes any number of list arguments and returns the first one that isn't empty.

coalescelist Function

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

coalescelist takes any number of list arguments and returns the first one that isn't empty.

Examples

> coalescelist(["a", "b"], ["c", "d"])
[
  "a",
  "b",
]
> coalescelist([], ["c", "d"])
[
  "c",
  "d",
]

To perform the coalescelist operation with a list of lists, use the ... symbol to expand the outer list as arguments:

> coalescelist([[], ["c", "d"]]...)
[
  "c",
  "d",
]
  • coalesce performs a similar operation with string arguments rather than list arguments.