sort メソッド
要素の順序を並べ替えた Array オブジェクトを返します。
function sort(sortFunction : Function ) : Array
引数
- sortFunction
省略可能です。 要素の順序を決定するために使用する関数の名前を指定します。
解説
sort メソッドは、指定された Array オブジェクト内の要素を並べ替えます。このメソッドを実行しても、新しい Array オブジェクトは作成されません。
引数 sortFunction を指定する場合は、次の戻り値を返すような関数を指定する必要があります。
1 つ目の引数が 2 つ目の引数よりも小さい場合は、負の値を返す関数。
2 つの引数が等しい場合は 0 を返す関数。
1 つ目の引数が 2 つ目の引数よりも大きい場合は、正の値を返す関数。
引数 sortFunction を省略すると、要素は ASCII コードの昇順で並べ替えられます。
使用例
sort メソッドの使用例を次に示します。
function SortDemo()
{
// Create an array.
var a = new Array("4", "11", "2", "10", "3", "1");
// Sort in ascending ASCII order.
// The array will contain 1,10,11,2,3,4.
a.sort();
// Sort the array elements numerically.
// Use a function that compares array elements.
// The array will contain 1,2,3,4,10,11.
a.sort(CompareForSort);
}
// This function is used by the sort method
// to sort array elements numerically.
// It accepts two string arguments that
// contain numbers.
function CompareForSort(param1, param2)
{
var first = parseInt(param1);
var second = parseInt(param2);
if (first == second)
return 0;
if (first < second)
return -1;
else
return 1;
}