Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Page properties
hiddentrue
Status
Tech review

Status
colourGreen
titledone

Style guide

Status
colourGreen
titledone

Status
titletodo
Status
colourYellow
titleReady for review
Status
colourGreen
titledone
Status
colourRed
titleflagged

Page properties
hiddentrue
Short description

Replaces the first substring matching a given regular expression with a given replacement.

Output Statussubtletruetitletext UI Text Box
sizemedium
typeinfo

This function replaces the first substring matching the given regular expressionwith the given replacement.

Code Block
languagebash
titleSyntax
linenumberstrue
replaceFirst(text, regex, replacement) #Output : Text
UI Expand
titleExamples
Parser expressionDescription
Code Block
languagebash
linenumberstrue
%{replaceFirst("Hello World", "l", "_")}

This example returns:

He_lo World

UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
text

Status
subtletrue
titletext

Any given text.
regex

Status
subtletrue
titletext

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

Status
subtletrue
titletext

This text will replace the first substring found by the regex.
UI Expand
titleOutput

This function returns a

Status
subtletrue
titletext

UI Text Box
typetip

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

Parser expressionValue
Code Block
languagebash
linenumberstrue
%{replaceFirst("Hello World", "l", "_")}
He_lo World
Code Block
languagebash
linenumberstrue
%{replaceAll("Hello World", "l", "_")}
He__o Wor_d
UI Text Box
typetip

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

Page properties
hiddentrue
Short description

Replaces the first substring matching a given regular expression with a given replacement.

Output

Status
subtletrue
titletext