| --- | |
| sidebar_label: join | |
| 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 all of the elements of the specified | |
| list of strings with the specified separator. | |
| ```hcl | |
| join(separator, list) | |
| ``` | |
| ## Examples | |
| ``` | |
| > join("-", ["foo", "bar", "baz"]) | |
| "foo-bar-baz" | |
| > join(", ", ["foo", "bar", "baz"]) | |
| foo, bar, baz | |
| > join(", ", ["foo"]) | |
| foo | |
| ``` | |
| ## Related Functions | |
| * [`split`](../../language/functions/split.mdx) performs the opposite operation: producing a list | |
| by separating a single string using a given delimiter. |