Uses a regular expression (RE) to search a string for a string pattern and replace it with another. The search is case-sensitive.
If the scope
parameter is set to one, returns a string with the first occurrence of the regular expression replaced by the value of substring.
If the scope
parameter is set to all, returns a string with all occurrences of the regular expression replaced by the value of substring.
If the function finds no matches, it returns a copy of the string unchanged.
REReplace(string
,reg_expression
,substring
[,scope
])
REFind, Replace, ReplaceList, REReplaceNoCase
ColdFusion MX: Added supports for the following special codes in a replacement substring, to control case conversion:
For more information on new features, see REFind.
Parameter |
Description |
---|---|
string |
A string or a variable that contains one. String within which to search. |
reg_expression |
Regular expression to replace. The search is case-sensitive. |
substring |
A string or a variable that contains one. Replaces reg_expression. |
scope |
|
For details on using regular expressions, see "Using Regular Expressions in Functions" in the ColdFusion Developer's Guide.
<p>The REReplace function returns <i>string</i> with a regular expression replaced with <i>substring</i> in the specified scope. Case-sensitive search. <p>REReplace("CABARET","C|B","G","ALL"): <cfoutput>#REReplace("CABARET","C|B","G","ALL")#</cfoutput> <p>REReplace("CABARET","[A-Z]","G","ALL"): <cfoutput>#REReplace("CABARET","[A-Z]","G","ALL")#</cfoutput> <p>REReplace("I love jellies","jell(y|ies)","cookies"): <cfoutput>#REReplace("I love jellies","jell(y|ies)","cookies")# </cfoutput> <p>REReplace("I love jelly","jell(y|ies)","cookies"): <cfoutput>#REReplace("I love jelly","jell(y|ies)","cookies")#</cfoutput>