View comments | RSS feed
Contents > CFML Reference > ColdFusion Functions > ReplaceList PreviousNext

ReplaceList

Replaces occurrences of the elements from a delimited list in a string with corresponding elements from another delimited list. The search is case-sensitive.

A copy of the string, after making replacements.

List functions, String functions

ReplaceList(string, list1, list2)

Find, REFind, Replace, REReplace

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

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.

<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>
Contents > CFML Reference > ColdFusion Functions > ReplaceList PreviousNext

ColdFusion 8 | ColdFusion MX 7 | ColdFusion MX 6.1 | ColdFusion MX | Forums | Developer Center | Bug Reporting

Version 6.1

Comments are no longer accepted for ColdFusion MX 6.1. ColdFusion 8 is the current version.

Comments


No screen name said on Mar 25, 2004 at 12:51 PM :
Pointer please: How to replace characters like " (speach mark) or , (comma) within this function?
No screen name said on Mar 25, 2004 at 1:03 PM :
OK, I figured it:

In order to use a # sign in a variable, you have to use the #chr(35)# to create it (if you just enter # coldfusion understandably expects another one to follow...

<cfset sSMark = "&#chr(35)#34;">
<cfset sComma = "&#chr(35)#44;">

and in order to find the characters like " and , you need to find those by using the chr(??) function too....

<cfset find_in_string = "#chr(34)#,#chr(44)#,">
<cfset replace_in_string = "#sSMark#,#sComma#">

eventually making the following useful....

<cfset validatedtext = #replacelist(#origtext#,#find_in_string#, #replace_in_string#)#>

(and don't forget you need to have #origtext# already!)
Supra LTD said on Sep 21, 2004 at 5:33 PM :
Hey,

How would I replacelist with replacenocase? I tried replacenocaselist but that doesn't work. Please help asap. THanks.

-Matt

 

RSS feed | Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/coldfusion/6.1/htmldocs/functa69.htm