This function replaces the first substring matching the given regular expression with the given replacement.

Syntax
replaceFirst(text, regex, replacement) #Output : Text
Examples
Parser expressionDescription
%{replaceFirst("Hello World", "l", "_")}

This example returns:

He_lo World

Additional information

Parameters used in this function

ParameterInput (data type)Description
text

TEXT

Any given text.
regex

TEXT

A valid regular expression that grabs the substring to be replaced.
replacement

TEXT

This text will replace the first substring found by the regex.
Output

This function returns a TEXT

If you want to replace all matching occurrences with the replacement, have a look at the replaceAll() function.

Parser expressionValue
%{replaceFirst("Hello World", "l", "_")}
He_lo World
%{replaceAll("Hello World", "l", "_")}
He__o Wor_d

If you don't want to use a regular expression, have a look at the findReplaceFirst() function.


Use cases and examples