MACROMEDIA COLFUSION MX 7 - INSTALLING AND USING COLDFUSION MX, Reference

Page: 819 / 1108

ReplaceNoCase 819
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
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>
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.