User Guide
Chapter 2: ColdFusion Functions 503
REReplace
Returns string with a regular expression being replaced with substring in the specified
scope. This is a case-sensitive search.
See also REFind, Replace, ReplaceList, and REReplaceNoCase.
Syntax REReplace(
string
,
reg_expression
,
substring
[,
scope
])
string
Any string.
reg_expression
Regular expression to be replaced. This regular expression can include POSIX-
specified character classes (for example, [:alpha:], [:digit:], [:upper:], and [:lower:]).
substring
String replacing reg_expression.
scope
Defines how to complete the replace operation:
•
ONE — Replace only the first occurrence (default).
•
ALL — Replace all occurrences.
Examples <!--- This example shows the use of REReplace --->
<HTML>
<HEAD>
<TITLE>
REReplace Example
</TITLE>
</HEAD>
<BODY BGCOLOR=silver>
<H3>REReplace Example</H3>
<P>The REReplace function returns <i>string</i> with a regular expression
being replaced with <i>substring</i> in the specified scope.
This is a 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>
</BODY>
</HTML>