Adobe ColdFusion 8

ReplaceNoCase

Description

Replaces occurrences of substring1 with substring2, in the specified scope. The search is case-insensitive.

Returns

A copy of the string, after making replacements.

Category

String functions

Function syntax

ReplaceNoCase(string, substring1, substring2 [, scope ])

See also

Find, REFind, Replace, ReplaceList, REReplace

Parameters

Parameter

Description
string

A string (or variable that contains one) within which to replace substring.
substring1

String (or variable that contains one) to replace, if found.
substring2

String (or variable that contains one) that replaces substring1.
scope
  • one: replaces the first occurrence (default).
  • all: replaces all occurrences.

Example

<h3>ReplaceNoCase Example</h3>
<p>The ReplaceNoCase function returns <I>string</I> with <I>substring1</I>
    replaced by <I>substring2</I> in the specified scope. 
    The search/replace is case-insensitive.

<cfif IsDefined("FORM.MyString")>
<p>Your original string, <cfoutput>#FORM.MyString#</cfoutput>
<p>You wanted to replace the substring <cfoutput>#FORM.MySubstring1#
 </cfoutput>
with the substring <cfoutput>#FORM.MySubstring2#</cfoutput>.
<p>The result: <cfoutput>#ReplaceNoCase(FORM.myString,
FORM.MySubstring1, FORM.mySubString2)#</cfoutput>
</cfif>