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>
       #ReplaceList(stringtoreplace,"dog,brown,fox,black",
    "cow,black,ferret,white")#
    </cfoutput>

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