User Guide

666 Chapter 3: ColdFusion Functions
REReplaceNoCase
Description
Uses a regular expression to search a string for a string pattern and replace it with another. The
search is case-insensitive.
Returns
• If scope = "one": returns a string with the first occurrence of the regular expression replaced
by the value of substring.
• If scope = "all": returns a string with all occurrences of the regular expression replaced by
the value of substring.
• If the function finds no matches: returns a copy of the string, unchanged.
Category
String functions
Function syntax
REReplaceNoCase(string, reg_expression, substring [, scope ])
See also
REFind, REFindNoCase, Replace, ReplaceList
History
ColdFusion MX: Changed behavior: this function inserts the following special characters in
regular expression replacement strings, to control case conversion: \u, \U, \l, \L, and \E. If any of
these strings is present in a ColdFusion 5 application, you must insert a backslash before it (for
example, change "\u" to "\\u").
Parameters
Usage
For details on using regular expressions, see Chapter 7, “Using Regular Expressions in Functions,”
in Developing ColdFusion MX Applications.
Example
<p>The REReplaceNoCase function returns <i>string</i> with a regular
expression replaced with <i>substring</i> in the specified scope.
This is a case-insensitive search.
<p>REReplaceNoCase("cabaret","C|B","G","ALL"):
<cfoutput>#REReplaceNoCase("cabaret","C|B","G","ALL")#</cfoutput>
<p>REReplaceNoCase("cabaret","[A-Z]","G","ALL"):
<cfoutput>#REReplaceNoCase("cabaret","[A-Z]","G","ALL")#</cfoutput>
<p>REReplaceNoCase("I LOVE JELLIES","jell(y|ies)","cookies"):
Parameter Description
string A string or a variable that contains one.
reg_expression Regular expression to replace. For more information, see Chapter 7, “Using
Regular Expressions in Functions,” in Developing ColdFusion MX Applications.
substring A string or a variable that contains one. Replaces
reg_expression.
scope •
one: Replace the first occurrence of the regular expression. Default.
•
all: Replace all occurrences of the regular expression.