User Guide

ReplaceList 661
ReplaceList
Description
Replaces occurrences of the elements from a delimited list in a string with corresponding elements
from another delimited list. The search is case-sensitive.
Returns
A copy of the string, after making replacements.
Category
List functions, String functions
Function syntax
ReplaceList(string, list1, list2)
See also
Find, REFind, Replace, REReplace
Parameters
Usage
The list of substrings to replace is processed sequentially. If a list1 element is contained in list2
elements, recursive replacement might occur. The second example shows this.
Example
<p>The ReplaceList function returns <I>string</I> with
<I>substringlist1</I> (e.g. "a,b") replaced by <I>substringlist2</I>
(e.g. "c,d") in the specified scope.
<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>#Replacelist(FORM.myString,
FORM.MySubstring1, FORM.mySubString2)#</cfoutput>
</cfif>
<form action = "replacelist.cfm" method="post">
<p>String 1
<br><input type = "Text" value = "My Test String" name = "MyString">
<p>Substring 1 (find this list of substrings)
<br><input type = "Text" value = "Test, String" name = "MySubstring1">
<p>Substring 2 (replace with this list of substrings)
<br><input type = "Text" value = "Replaced, Sentence" name = "MySubstring2">
<p><input type = "Submit" value = "Replace and display" name = "">
</form>
<h3>Replacelist Example Two</h3>
<cfset stringtoreplace = "The quick brown fox jumped over the lazy dog.">
<cfoutput>
Parameter Description
string A string, or a variable that contains one, within which to replace substring
list1 Comma-delimited list of substrings for which to search
list2 Comma-delimited list of replacement substrings