elasticsearch/docs/reference/esql/functions/replace.asciidoc
Abdon Pijpelink e87c49cb4b
[DOCS] Improve ES|QL functions reference for functions E-Z (#104623)
* Functions E-Z

* Incorporate changes from #103686

* More functions

* More functions

* Update docs/reference/esql/functions/floor.asciidoc

Co-authored-by: Liam Thompson <32779855+leemthompo@users.noreply.github.com>

* Update docs/reference/esql/functions/left.asciidoc

Co-authored-by: Liam Thompson <32779855+leemthompo@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: Alexander Spies <alexander.spies@elastic.co>

* Review feedback

* Fix geo_shape description

* Change 'colum'/'field' into 'expressions'

* Review feedback

* One more

---------

Co-authored-by: Liam Thompson <32779855+leemthompo@users.noreply.github.com>
Co-authored-by: Alexander Spies <alexander.spies@elastic.co>
Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
2024-01-25 16:32:24 +01:00

44 lines
805 B
Text

[discrete]
[[esql-replace]]
=== `REPLACE`
*Syntax*
[.text-center]
image::esql/functions/signature/replace.svg[Embedded,opts=inline]
*Parameters*
`str`::
String expression.
`regex`::
Regular expression.
`newStr`::
Replacement string.
*Description*
The function substitutes in the string `str` any match of the regular expression
`regex` with the replacement string `newStr`.
If any of the arguments is `null`, the result is `null`.
*Supported types*
include::types/replace.asciidoc[]
*Example*
This example replaces any occurrence of the word "World" with the word
"Universe":
[source.merge.styled,esql]
----
include::{esql-specs}/docs.csv-spec[tag=replaceString]
----
[%header.monospaced.styled,format=dsv,separator=|]
|===
include::{esql-specs}/docs.csv-spec[tag=replaceString-result]
|===