REPLACE | |
Description
Replaces occurrences of substring1 in a string with substring2, in a specified scope. The search is case-sensitive. |
|
Returns
The string, after making replacements. |
|
Category
String functions |
|
Function syntaxReplace(string, substring1, substring2 [, scope ]) |
|
See also
Find, REFind, ReplaceNoCase, ReplaceList, REReplace |
|
Parameters
|
|
Usage
To 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> |
STRING | |
SUBSTRING1 | |
SUBSTRING2 | |
SCOPE | |