elasticsearch/docs/reference/query-languages/esql/_snippets/functions/replace.md
Colleen McGinnis b7e3a1e14b
[docs] Migrate docs from AsciiDoc to Markdown (#123507)
* delete asciidoc files

* add migrated files

* fix errors

* Disable docs tests

* Clarify release notes page titles

* Revert "Clarify release notes page titles"

This reverts commit 8be688648d.

* Comment out edternal URI images

* Clean up query languages landing pages, link to conceptual docs

* Add .md to url

* Fixes inference processor nesting.

---------

Co-authored-by: Liam Thompson <32779855+leemthompo@users.noreply.github.com>
Co-authored-by: Liam Thompson <leemthompo@gmail.com>
Co-authored-by: Martijn Laarman <Mpdreamz@gmail.com>
Co-authored-by: István Zoltán Szabó <szabosteve@gmail.com>
2025-02-27 17:56:14 +01:00

1,015 B

REPLACE [esql-replace]

Syntax

:::{image} ../../../../../images/replace.svg :alt: Embedded :class: text-center :::

Parameters

string
String expression.
regex
Regular expression.
newString
Replacement string.

Description

The function substitutes in the string str any match of the regular expression regex with the replacement string newStr.

Supported types

string regex newString result
keyword keyword keyword keyword
keyword keyword text keyword
keyword text keyword keyword
keyword text text keyword
text keyword keyword keyword
text keyword text keyword
text text keyword keyword
text text text keyword

Example

This example replaces any occurrence of the word "World" with the word "Universe":

ROW str = "Hello World"
| EVAL str = REPLACE(str, "World", "Universe")
| KEEP str
str:keyword
Hello Universe