hugo/docs/content/en/functions/replace.md
2023-08-30 19:24:34 +02:00

24 lines
612 B
Markdown

---
title: replace
description: Replaces all occurrences of the search string with the replacement string.
categories: [functions]
menu:
docs:
parent: functions
keywords: [replace]
signature:
- "replace INPUT OLD NEW [LIMIT]"
- "strings.Replace INPUT OLD NEW [LIMIT]"
relatedfuncs: [replaceRE]
---
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"
```