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 syntax

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

See also
Find, REFind, ReplaceNoCase, ReplaceList, REReplace
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 | one: replace the first occurrence (default)
| all: replace all occurrences

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 |
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 |

- one: replace the first occurrence (default)
- all: replace all occurrences