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

934 B

layout page_title sidebar_current description
functions coalesce - Functions - Configuration Language docs-funcs-collection-coalesce-x The coalesce function takes any number of string arguments and returns the first one that isn't 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 string arguments and returns the first one that isn't empty.

Examples

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

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 string arguments.