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

Status
subtletrue
titletext




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.