|
Replace
DescriptionReplaces
occurrences of substring1 in a string with substring2,
in a specified scope. The search is case sensitive.
ReturnsThe
string, after making replacements.
Function syntaxReplace(string, substring1, substring2 [, scope ])
Parameters
Parameter
|
Description
|
string
|
A string or a variable that contains one.
String in which to search.
|
substring1
|
A string or a variable that contains one.
String for which to search
|
substring2
|
String that replaces substring1
|
scope
|
|
UsageTo remove
a string, specify the empty string ("") as substring2.
You
do not need to escape comma characters in strings. For example,
the following code deletes the commas from the sentence:
replace("The quick brown fox jumped over the lazy cow, dog, and cat.",",","","All")
Example<h3>Replace Example</h3>
<p>The Replace function returns <I>string</I> with <I>substring1</I>
replaced by <I>substring2</I> in the specified scope. This
is a case-sensitive search.
<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>#Replace(FORM.myString,
FORM.MySubstring1, FORM.mySubString2)#</cfoutput>
</cfif>
|