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

44 lines
1.3 KiB
Markdown
Raw Normal View History

---
layout: "functions"
page_title: "replace - Functions - Configuration Language"
sidebar_current: "docs-funcs-string-replace"
description: |-
The replace function searches a given string for another given substring,
2019-03-21 20:20:29 +01:00
and replaces all occurrences with a given replacement string.
---
# `replace` Function
-> **Note:** This page is about Terraform 0.12 and later. For Terraform 0.11 and
earlier, see
[0.11 Configuration Language: Interpolation Syntax](../../configuration-0-11/interpolation.html).
`replace` searches a given string for another given substring, and replaces
2019-03-21 20:20:29 +01:00
each occurrence with a given replacement string.
```hcl
replace(string, substring, replacement)
```
2019-07-11 18:29:41 +02:00
If `substring` is wrapped in forward slashes, it is treated as a regular
expression, using the same pattern syntax as
[`regex`](./regex.html). If using a regular expression for the substring
argument, the `replacement` string can incorporate captured strings from
the input by using an `$n` sequence, where `n` is the index or name of a
capture group.
2019-07-11 18:29:41 +02:00
## Examples
```
> replace("1 + 2 + 3", "+", "-")
1 - 2 - 3
2019-07-11 18:29:41 +02:00
> replace("hello world", "/w.*d/", "everybody")
hello everybody
```
## Related Functions
- [`regex`](./regex.html) searches a given string for a substring matching a
given regular expression pattern.