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>

CFML Language Reference
Chapter 2 : ColdFusion Functions