replace

Description

Replaces occurrences of substring1 in a string with substring2, in a specified scope. The search is case sensitive.

Syntax

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

Attributes

Attribute	Description	Required	Default
scope	one: replaces the first occurrence (default) all: replaces all occurrences
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

Returns

The string, after making replacements.

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> 
 
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")> 
Your original string, <cfoutput>#FORM.MyString#</cfoutput> 
You wanted to replace the substring <cfoutput>#FORM.MySubstring1# 
    </cfoutput> 
    with the substring <cfoutput>#FORM.MySubstring2#</cfoutput>. 
The result: <cfoutput>#Replace(FORM.myString,  
    FORM.MySubstring1, FORM.mySubString2)#</cfoutput> 
</cfif>

cfmldocs