User Guide

820 Chapter 3: ColdFusion Functions
REReplace
Description
Uses a regular expression (RE) to search a string for a string pattern and replace it with another.
The search is case-sensitive.
Returns
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.
Category
String functions
Function syntax
REReplace(string, reg_expression, substring [, scope ])
See also
REFind
, Replace, ReplaceList, REReplaceNoCase
History
ColdFusion MX: Added supports for the following special codes in a replacement substring, to
control case conversion:
• \u - uppercase the next character
• \l - lowercase the next character
• \U - uppercase until \E
• \L - lowercase until \E
• \E - end \U or \L
For more information on new features, see
REFind.
Parameters
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 • one: replaces the first occurrence (default).
• all: replaces all occurrences.