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>

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

SUBSTRING |

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

SCOPE |

- one: replaces the first occurrence of the regular expression. Default.
- all: replaces all occurrences of the regular expression.