aboutsummaryrefslogtreecommitdiffhomepage
path: root/docs/content/en/functions/strings/Replace.md
blob: 8d5e548594a5c9f3b38caf73c4512014bc93fd95 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
---
title: strings.Replace
linkTitle: replace
description: Replaces all occurrences of the search string with the replacement string.
categories: [functions]
keywords: []
menu:
  docs:
    parent: functions
function:
  aliases: [replace]
  returnType: string
  signatures: ['strings.Replace INPUT OLD NEW [LIMIT]']
relatedFunctions:
  - strings.FindRE
  - strings.FindRESubmatch
  - strings.Replace
  - strings.ReplaceRE
aliases: [/functions/replace]
---

Replace returns a copy of `INPUT` with all occurrences of `OLD` replaced with `NEW`.
The number of replacements can be limited with an optional `LIMIT` argument.

```
{{ replace "Batman and Robin" "Robin" "Catwoman" }}
→ "Batman and Catwoman"

{{ replace "aabbaabb" "a" "z" 2 }} → "zzbbaabb"
```