MACROMEDIA COLFUSION MX 7 - INSTALLING AND USING COLDFUSION MX, Reference

Page: 820 / 1108

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.