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 ColdFusion MX Developer's Guide.

 
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"):   
<cfoutput>#REReplaceNoCase("I LOVE JELLIES","jell(y|ies)","cookies")#
</cfoutput>
<p>REReplaceNoCase("I LOVE JELLY","jell(y|ies)","cookies"):   
<cfoutput>#REReplaceNoCase("I LOVE JELLY","jell(y|ies)","cookies")#
</cfoutput>

A string or a variable that contains one.

STRING  

Regular expression to replace. For more information, see Chapter 7, "Using Regular Expressions in Functions," in ColdFusion MX Developer's Guide.

REG_EXPRESSION  

A string or a variable that contains one. Replaces reg_expression.

SUBSTRING  
SCOPE