|
ReplaceList
DescriptionReplaces
occurrences of the elements from a delimited list in a string with
corresponding elements from another delimited list. The search is
case sensitive.
ReturnsA copy
of the string, after making replacements.
Function syntaxReplaceList(string, list1, list2)
Parameters
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
|
UsageThe 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>
|