MACROMEDIA COLFUSION MX 7-CFML Reference page 484

Parameter Description
sort_type • numeric: sorts numbers
• text: sorts text alphabetically, taking case into account (also known as case
• textnocase: sorts text alphabetically, without regard to case (also known as case-
sort_order • asc - ascending sort order. Default.
• desc - descending sort order.
Throws
If an array element is other than a simple element, this function throws an
ArraySortSimpleValueException error. If
numeric, this function throws a ValueNotNumeric error.
Example
<!--- This example shows ArraySort --->
<cfquery name = "GetEmployeeNames" datasource = "cfdocexamples">
SELECT FirstName, LastName FROM Employees
</cfquery>
<!--- create an array --->
<cfset myArray = ArrayNew(1)>
<!--- loop through the query and append these names successively to the last
element --->
<cfloop query = "GetEmployeeNames">
<cfset temp = ArrayAppend(myArray, "#FirstName# #LastName#")>
</cfloop>
<!--- show the resulting array as a list --->
<cfset myList = ArrayToList(myArray, ",")>
<!--- sort that array descending alphabetically --->
<cfset isSuccessful = ArraySort(myArray, "textnocase", "desc")>
...
484 Chapter 3: ColdFusion Functions
sensitive). All letters of one case precede the first letter of the other case:
- aabzABZ, if
sort_order = "asc"
- ZBAzbaa, if
sort_order = "desc"
insensitive). A letter in varying cases precedes the next letter:
- aAaBbBzzZ, in an ascending sort; preserves original intra-letter order
- ZzzBbBaAa, in a descending sort; reverses original intra-letter order
- aabzABZ or aAaBbBzzZ, depending on value of
- from smaller to larger, for numbers
- ZBAzbaa or ZzzBbBaAa, depending on value of
- from larger to smaller, for numbers
(ascending sort)
(descending sort)
is numeric and an array element is not
sort_type
, for letters
sort_type
, for letters
sort_type