string.rEReplace()

edit

Uses a regular expression (RE) to search a string for a string pattern and replace it with another. The search is case-sensitive.

string.rEReplace( regex=string, substring=string, scope=string )

Returns: String

Argument Description
regex
string, required 		edit

Regular expression to replace.

Alias: reg_expression
substring
string, required 		edit

replacement
scope
string, optional 		edit
  • one (default): Replace the first occurrence of the regular expression.
  • all: Replace all occurrences of the regular expression.

Examples

edit 
str = "count the NUMBERS 123... or ONE,TWO,THREE";
res = str.rereplace("[0-9]+","[one,two,three]","all");
writeDump(res);
res = str.rereplace("[a-z]+","1","all");
writeDump(res);
res = str.rereplace("[a-z]","1","all");
writeDump(res);
res = str.rereplace("[a-z]+","I Love Lucee","all");
writeDump(res);

See also