39 lines
785 B
Markdown
39 lines
785 B
Markdown
|
---
|
||
|
|
layout: "docs"
|
||
|
|
page_title: "coalesce - Functions - Configuration Language"
|
||
|
|
sidebar_current: "configuration-functions-collection-coalesce-x"
|
||
|
|
description: |-
|
||
|
|
The coalesce function takes any number of arguments and returns the
|
||
|
|
first one that isn't null nor empty.
|
||
|
|
---
|
||
|
|
|
||
|
|
# `coalesce` Function
|
||
|
|
|
||
|
|
|
||
|
|
`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
|
||
|
|
```
|
||
|
|
|
||
|
|
## Related Functions
|
||
|
|
|
||
|
|
* [`coalescelist`](./coalescelist.html) performs a similar operation with
|
||
|
|
list arguments rather than individual arguments.
|