User Guide

ListSort 737
Usage
ColdFusion ignores empty list elements; thus, the list "a,b,c,,,d" has four elements.
Example
<h3>ListSort Example</h3>
<!--- Find a list of users who wrote messages --->
<cfquery name = "GetMessageUser" datasource = "cfdocexamples">
SELECT Username, Subject, Posted
FROM Messages
</cfquery>
<cfset myList = ValueList(GetMessageUser.UserName)>
<p>Here is the unsorted list. </p>
<cfoutput>#myList#
</cfoutput>
<p>Here is the list sorted alphabetically:</p>
<cfset sortedList = ListSort(myList, "Text")>
<cfoutput>#sortedList#
</cfoutput>
<p>Here is a numeric list that is to be sorted in descending order.</p>
<cfset sortedNums = ListSort("12,23,107,19,1,65","Numeric", "Desc")>
<cfoutput>#sortedNums# </cfoutput>
<p>Here is a list that must be sorted numerically, since it contains
negative and positive numbers, and decimal numbers. </p>
<cfset sortedNums2 = ListSort("23.75;-34,471:100,-9745","Numeric", "ASC",
";,:")>
<cfoutput>#sortedNums2# </cfoutput>
<p>Here is a list to be sorted alphabetically without consideration of case.</
p>
<cfset sortedMix =
ListSort("hello;123,HELLO:jeans,-345,887;ColdFusion:coldfusion",
"TextNoCase", "ASC", ";,:")>
<cfoutput>#sortedMix# </cfoutput>
sort_order • asc - ascending sort order. Default.
- aabzABZ or aAaBbBzzZ, depending on value of
sort_type, for letters
- from smaller to larger, for numbers
• desc - descending sort order.
- ZBAzbaa or ZzzBbBaAa, depending on value of
sort_type, for letters
- from larger to smaller, for numbers
delimiters A string or a variable that contains one. Character(s) that separate list elements. The
default value is comma.
If this parameter contains more than one character, ColdFusion uses the first character
in the string as the delimiter, and ignores the rest.
Parameter Description