# REReplaceNoCase

Returns string with a regular expression being replaced with substring in the specified scope. The search is case-insensitive.

See also REFind, REFindNoCase, Replace, and ReplaceList.

### Syntax

    REReplaceNoCase(string, reg_expression, substring [, scope ])

##### string

Any string.

##### reg_expression

Regular expression to be replaced. This regular expression can include POSIX-specified character classes (for example, [:alpha:], [:digit:], [:upper:], and [:lower:]).

##### substring

String replacing reg_expression.

##### scope

Defines how to complete the replace operation:

- `ONE` -- Replace only the first occurrence (default).
- `ALL` -- Replace all occurrences.

### Examples

    <!--- This example shows the use of REReplaceNoCase --->
    <HTML>
    <HEAD>
    <TITLE>
    REReplaceNoCase Example
    </TITLE>
    </HEAD>
    <BODY BGCOLOR=silver>
    <H3>REReplaceNoCase Example</H3>
    <P>The REReplaceNoCase function returns <i>string</i> with a regular
    expression being 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>
    </BODY>
    </HTML>