opentofu/website/docs/language/functions/split.mdx

---
sidebar_label: split
description: |-
  The split function produces a list by dividing a given string at all
  occurrences of a given separator.
---

# `split` Function

`split` produces a list by dividing a given string at all occurrences of a
given separator.

```hcl
split(separator, string)
```

## Examples

```
> split(",", "foo,bar,baz")
[
  "foo",
  "bar",
  "baz",
]
> split(",", "foo")
[
  "foo",
]
> split(",", "")
[
  "",
]
```

## Related Functions

* [`join`](../../language/functions/join.mdx) performs the opposite operation: producing a string
  joining together a list of strings with a given separator.
website: Beginnings of "Functions" configuration section Previously we just listed out all of the functions in alphabetical order inside the "Interpolation Syntax" page, but that format doesn't leave much room for details and usage examples. Now we give each function its own page, and categorize them for easier navigation. While many functions are very simple and don't really warrant a full page, certain functions do have additional details that are worth mentioning and this structure scales better for those more complicated functions. So far this includes only the numeric and string functions. Other categories will follow in subsequent commits. 2018-05-06 21:32:16 -04:00			`---`
Clean up frontmatter sections in the docs (#421) 2023-09-15 10:03:23 -04:00			`sidebar_label: split`
website: Beginnings of "Functions" configuration section Previously we just listed out all of the functions in alphabetical order inside the "Interpolation Syntax" page, but that format doesn't leave much room for details and usage examples. Now we give each function its own page, and categorize them for easier navigation. While many functions are very simple and don't really warrant a full page, certain functions do have additional details that are worth mentioning and this structure scales better for those more complicated functions. So far this includes only the numeric and string functions. Other categories will follow in subsequent commits. 2018-05-06 21:32:16 -04:00			`description: \|-`
			`The split function produces a list by dividing a given string at all`
website: Fix several spelling errors 2019-03-21 15:20:29 -04:00			`occurrences of a given separator.`
website: Beginnings of "Functions" configuration section Previously we just listed out all of the functions in alphabetical order inside the "Interpolation Syntax" page, but that format doesn't leave much room for details and usage examples. Now we give each function its own page, and categorize them for easier navigation. While many functions are very simple and don't really warrant a full page, certain functions do have additional details that are worth mentioning and this structure scales better for those more complicated functions. So far this includes only the numeric and string functions. Other categories will follow in subsequent commits. 2018-05-06 21:32:16 -04:00			`---`

			# `split` Function

website: Fix several spelling errors 2019-03-21 15:20:29 -04:00			`split` produces a list by dividing a given string at all occurrences of a
website: Beginnings of "Functions" configuration section Previously we just listed out all of the functions in alphabetical order inside the "Interpolation Syntax" page, but that format doesn't leave much room for details and usage examples. Now we give each function its own page, and categorize them for easier navigation. While many functions are very simple and don't really warrant a full page, certain functions do have additional details that are worth mentioning and this structure scales better for those more complicated functions. So far this includes only the numeric and string functions. Other categories will follow in subsequent commits. 2018-05-06 21:32:16 -04:00			`given separator.`

			```hcl
			`split(separator, string)`
			```

			`## Examples`

			```
			`> split(",", "foo,bar,baz")`
			`[`
			`"foo",`
			`"bar",`
			`"baz",`
			`]`
			`> split(",", "foo")`
			`[`
			`"foo",`
			`]`
			`> split(",", "")`
			`[`
			`"",`
			`]`
			```

			`## Related Functions`

Versioned docs: replacing docs links with relative variants (#1537) Signed-off-by: Janos <86970079+janosdebugs@users.noreply.github.com> Signed-off-by: Damian Stasik <920747+damianstasik@users.noreply.github.com> Signed-off-by: Roman Grinovski <roman.grinovski@gmail.com> Co-authored-by: Damian Stasik <920747+damianstasik@users.noreply.github.com> Co-authored-by: Roman Grinovski <roman.grinovski@gmail.com> 2024-04-24 07:24:30 -04:00			* [`join`](../../language/functions/join.mdx) performs the opposite operation: producing a string
website: Beginnings of "Functions" configuration section Previously we just listed out all of the functions in alphabetical order inside the "Interpolation Syntax" page, but that format doesn't leave much room for details and usage examples. Now we give each function its own page, and categorize them for easier navigation. While many functions are very simple and don't really warrant a full page, certain functions do have additional details that are worth mentioning and this structure scales better for those more complicated functions. So far this includes only the numeric and string functions. Other categories will follow in subsequent commits. 2018-05-06 21:32:16 -04:00			`joining together a list of strings with a given separator.`