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
|
|
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. |
|
|
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"):
<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>
|