118
Chapter 2: ActionScript Language Reference
By default,
Array
.
sortOn()
works as described in the following list:
•
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”.
You can use the
option
flags to override these defaults. The following examples use different
forms of the
option
flag for illustration purposes. If you want to sort a simple array (for example,
an array with only one field), or if you want to specify a sort order that the
options
parameter
doesn’t support, use
Array.sort()
.
To pass multiple flags in numeric format, separate them with the bitwise OR (
|
) operator or add
the values of the flags together. The following code shows three ways to specify a numeric
descending sort:
my_array.sortOn(someFieldName, 2 | 16);
my_array.sortOn(someFieldName, 18);
my_array.sortOn(someFieldName, Array.DESCENDING | Array.NUMERIC);
Code hinting (see “Using code hints”
in
Using ActionScript in Flash
) is enabled if you use the
string form of the flag (for example,
DESCENDING
) rather than the numeric form (2).
Consider the following array:
var my_array:Array = new Array();
my_array.push({password: "Bob", age:29});
my_array.push({password: "abcd", age:3});
my_array.push({password: "barb", age:35});
my_array.push({password: "catchy", age:4});
Performing a default sort on the password field produces the following results:
my_array.sortOn("password");
// Bob
// abcd
// barb
// catchy
Performing a case-insensitive sort on the password field produces the following results:
my_array.sortOn("password", Array.CASEINSENSITIVE);
// abcd
// barb
// Bob
// catchy
Performing a case-insensitive, descending sort on the password field produces the following
results:
my_array.sortOn("password", 1|2);
// catchy
// Bob
Summary of Contents for FLASH MX 2004-ACTIONSCRIPT LANGUAGE
Page 1: ...ActionScript Language Reference...
Page 20: ...20 Contents...
Page 24: ...24 Chapter 1 Introduction...
Page 145: ...Button onKeyDown 145 See also Button onKeyUp...
Page 186: ...186 Chapter 2 ActionScript Language Reference See also Camera onActivity Camera setMotionLevel...
Page 202: ...202 Chapter 2 ActionScript Language Reference See also break default strict equality switch...
Page 282: ...282 Chapter 2 ActionScript Language Reference See also break continue while...
Page 383: ...LoadVars addRequestHeader 383 See also XML addRequestHeader...
Page 388: ...388 Chapter 2 my_lv load place a valid URL pointing to a text file here...
Page 463: ...Microphone setRate 463 See also Microphone rate...
Page 469: ...Microphone silenceLevel 469 See also Microphone gain Microphone setSilenceLevel...
Page 480: ...480 Chapter 2 ActionScript Language Reference See also Mouse addListener...
Page 529: ...MovieClip globalToLocal 529 See also MovieClip getBounds MovieClip localToGlobal...
Page 612: ...612 Chapter 2 ActionScript Language Reference See also MovieClipLoader onLoadStart...
Page 623: ...NetConnection class 623 See also NetStream class Video attachVideo...
Page 649: ...Number 649 See also NaN Number class...
Page 679: ...on 679 on release trace X this _x trace Y this _y stopDrag See also onClipEvent...
Page 683: ...onUpdate 683 buttonLabel textColor my_mc labelColor...
Page 788: ...788 Chapter 2 ActionScript Language Reference See also private public...
Page 1001: ...Video height 1001 my_mc _height my_mc my_video height See also MovieClip _height Video width...
Page 1022: ...1022 Chapter 2 ActionScript Language Reference See also XML createElement...
Page 1057: ...XML xmlDecl 1057 See also XML docTypeDecl XML toString...
Page 1070: ...1070 Chapter 2 ActionScript Language Reference...