Uses a regular expression to search a string for a string pattern and replace it with another. The search is case-insensitive.
REReplaceNoCase(string
,reg_expression
,substring
[,scope
])
REFind, REFindNoCase, Replace, ReplaceList
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").
Parameter |
Description |
---|---|
string |
A string or a variable that contains one. |
reg_expression |
Regular expression to replace. For more information, see "Using Regular Expressions in Functions" in the ColdFusion Developer's Guide. |
substring |
A string or a variable that contains one. Replaces reg_expression. |
scope |
|
For details on using regular expressions, see "Using Regular Expressions in Functions" in the ColdFusion Developer's Guide.
<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>