MACROMEDIA FLEX-FLEX ACTIONSCRIPT LANGUAGE Reference page 249

One or more numbers or names of defined constants, separated by the
option
operator, that change the behavior of the sort from the default. The following values are
acceptable for
option
•
1 or
Array.CASEINSENSITIVE
•
2 or
Array.DESCENDING
•
4 or
Array.UNIQUESORT
•
8 or
Array.RETURNINDEXEDARRAY
•
16 or
Array.NUMERIC
For information on this parameter, see
Note: Array.sort() is defined in ECMA-262, but the array sorting options introduced in Flash
Player 7 are Flash-specific extensions to the ECMA-262 specification.
Returns
The return value depends on whether you pass any parameters, as described in the following list:
•
If you specify a value of 4 or
sorted have identical sort fields, Flash returns a value of 0 and does not modify the array.
•
If you specify a value of 8 or
that reflects the results of the sort and does not modify the array.
•
Otherwise, Flash returns nothing and modifies the array to reflect the sort order.
Description
Method; sorts the elements in an array. Flash sorts according to Unicode values. (ASCII is a subset
of Unicode.)
By default, .
Array sort()
•
Sorting is case-sensitive (Z precedes a).
•
Sorting is ascending (a precedes b).
•
The array is modified to reflect the sort order; multiple elements that have identical sort fields
are placed consecutively in the sorted array in no particular order.
•
Numeric fields are sorted as if they were strings, so 100 precedes 99, because "1" is a lower
string value than "9".
If you want to sort in another way, create a function to do the sorting and pass its name as the
compareFunction
by last name, ascending, and then by ZIP code, descending.
If you want to specify one or more fields on which to sort, using either the default sort or the
parameter, use
options
:
Array.sortOn()
Array.UNIQUESORT
Array.RETURNINDEXEDARRAY
works as described in the following list:
parameter. You might do this, for example, if you want to sort alphabetically
Array.sortOn()
.
for
option
for
.
| (bitwise OR)
and two or more elements being
, Flash returns an array
option
Array.sort() 249