Macromedia coldfusion 4.5-cfml language reference User Manual

500

CFML Language Reference

ReplaceList

Returns string with all occurrences of the elements from the specified comma-
delimited list being replaced with their corresponding elements from another comma-
delimited list. The search is case-sensitive.

See also

Find

Replace,

and

REReplace

Syntax

ReplaceList(

string, list1, list2)

string

Any string.

list1

Comma-delimited list of substrings to be replaced.

list2

Comma-delimited list of replace substrings.

Usage

Note that the list of substrings to be replaced is processed one after another. In this
way you may experience recursive replacement if one of your list1 elements is
contained in list2 elements. The second example listed below demonstrates such
replacement.

Examples

<HTML>
<HEAD>
<TITLE>
Replacelist Example
</TITLE>
</HEAD>

<BODY BGCOLOR=silver>
<H3>Replacelist Example</H3>

<P>The Replacelist function returns <I>string</I> with
<I>substringlist1</I> (e.g. "a,b") being replaced by <I>substringlist2
</I> (e.g. "c,d") in the specified scope.

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