2020-02-06 11:49:21 +01:00
|
|
|
---
|
2020-03-18 18:46:47 -04:00
|
|
|
layout: docs
|
|
|
|
|
page_title: join - Functions - Configuration Language
|
2020-04-02 19:39:47 -04:00
|
|
|
sidebar_title: join
|
2020-02-06 11:49:21 +01:00
|
|
|
description: |-
|
|
|
|
|
The join function produces a string by concatenating the elements of a list
|
|
|
|
|
with a given delimiter.
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
# `join` Function
|
|
|
|
|
|
|
|
|
|
`join` produces a string by concatenating together all elements of a given
|
|
|
|
|
list of strings with the given delimiter.
|
|
|
|
|
|
|
|
|
|
```hcl
|
|
|
|
|
join(separator, list)
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Examples
|
|
|
|
|
|
2020-05-29 17:12:05 -04:00
|
|
|
```shell-session
|
2020-02-06 11:49:21 +01:00
|
|
|
> join(", ", ["foo", "bar", "baz"])
|
|
|
|
|
foo, bar, baz
|
|
|
|
|
> join(", ", ["foo"])
|
|
|
|
|
foo
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Related Functions
|
|
|
|
|
|
2020-04-01 15:15:54 -04:00
|
|
|
- [`split`](/docs/from-1.5/functions/string/split) performs the opposite operation: producing a list
|
2020-02-06 11:49:21 +01:00
|
|
|
by separating a single string using a given delimiter.
|
