ReplaceList

Description

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

Syntax


ReplaceList(string, list1, list2)

Parameters

Parameter

Description

string
A string

list1
Comma-delimited list of substrings to replace

list2
Comma-delimited list of replace substrings

Parameter	Description
string	A string
list1	Comma-delimited list of substrings to replace
list2	Comma-delimited list of replace substrings

Usage

The list of substrings to be replaced is processed sequentially. There may be recursive replacement if a list1 element is contained in list2 elements. The second example demonstrates this.

Example

<!--- This example shows the use of Replacelist --->

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



</body>

</html>