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

969 B

layout page_title sidebar_current description
functions coalesce - Functions - Configuration Language docs-funcs-collection-coalesce-x The coalesce function takes any number of arguments and returns the first one that isn't null nor empty.

coalesce Function

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

coalesce takes any number of arguments and returns the first one that isn't null or an empty string.

Examples

> coalesce("a", "b")
a
> coalesce("", "b")
b
> coalesce(1,2)
1

To perform the coalesce operation with a list of strings, use the ... symbol to expand the list as arguments:

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