MACROMEDIA COLDFUSION MX 61-CFML Reference page 588

Parameter Description
sort_order • asc - ascending sort order. Default.
- aabzABZ or aAaBbBzzZ, depending on value of
- from smaller to larger, for numbers
• desc - descending sort order.
- ZBAzbaa or ZzzBbBaAa, depending on value of
- from larger to smaller, for numbers
delimiters A string or a variable that contains one. Character(s) that separate list elements.
Default: comma.
If this parameter contains more than one character, ColdFusion uses the first character
in the string as the delimiter, and ignores the rest.
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 = "cfsnippets">
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>
588 Chapter 3: ColdFusion Functions
, for letters
sort_type
, for letters
sort_type