javascript Array sort( )
| sort( ) | Firefox/Netscape/NN 3 IE 4 ECMA 1 | ||||||||
sort([compareFunction]) |
|||||||||
Sorts the values of the array either by the ASCII value of string versions of each array entry or according to a comparison function of your own design. The sort( ) method repeatedly invokes the comparison function, passing two values from the array. The comparison function should return an integer value, which is interpreted by the sort( ) function as follows. |
|||||||||
|
|||||||||
The following comparison function sorts values of an array in numerical (instead of ASCII) order:
function doCompare(a, b) {
return a - b
}
|
|||||||||
To sort an array by this function, the statement is: myArray.sort(doCompare) |
|||||||||
By the time the sort( ) method has completed its job, it has sent all values to the doCompare( ) function two values at a time and sorted the values on whether the first value is larger than the second (in the manner of a bubble sort). |
|||||||||
Not only does the sort( ) method rearrange the values in the array, but it also returns a copy of the sorted array. |
|||||||||
| Parameters | |||||||||
|
|||||||||
| Returned Value | |||||||||
An Array object, sorted according to sorting criteria. |
|||||||||
Powered by Linode.