MACROMEDIA COLFUSION MX 7-CFML, Reference

Page: 483 / 1108

ArraySort 483
ArraySort
Description
Sorts array elements numerically or alphanumerically.
Returns
True, if sort is successful; False, otherwise.
Category
Array functions , List functions
Function syntax
ArraySort ( array , sort_type [, sort_order ])
History
ColdFusion MX:
•
Changed thrown exceptions: this function can throw the ArraySortSimpleValueException
error and ValueNotNumeric error.
•
Changed the order in which sorted elements are returned: in a
textnocase
, descending sort,
this function might return elements in a different sort order than in earlier releases. If
sort_type = "textnocase"
and
sort_order = "desc"
, ColdFusion MX processes
elements that differ only in case differently from earlier releases, as follows:
■
ColdFusion MX reverses the elements’ original order.
■
Earlier releases of ColdFusion do not change the elements’ original order.
For example, in a
textnocase
,
desc
sort of
d,a,a,b,A
, the following occurs:
■
ColdFusion MX returns
d,b,A,a,a
■
Earlier ColdFusion releases return
d,b,a,a,A
Parameters
Parameter Description
array Name of an array