usort

(PHP3 >= 3.0.3, PHP4 )

usort --  ユーザー定義の比較関数により値で配列をソートします

説明

void usort (array array, function cmp_function)

この関数は、ユーザー定義の比較関数により配列をその値でソートします。 ソートしたい配列を複雑な基準でソートする必要がある場合、 この関数を使用するべきです。

比較関数は、最初の引数が二番目の引数より小さいか等しいか大きい場合に それぞれゼロ未満、ゼロに等しい、ゼロより大きい整数を返します。二つの メンバーの比較結果が等しいとなった場合、ソートされた配列の順番は定義 されません。

例 1. usort()の例


function cmp ($a, $b) {   
    if ($a == $b) return 0;
    return ($a > $b) ? -1 : 1;
}
$a = array (3, 2, 5, 6, 1);
usort ($a, cmp);
while (list ($key, $value) = each ($a)) {
    echo "$key: $value\n";
}
      
この例は以下を表示します: 0: 6 1: 5 2: 3 3: 2 4: 1

注意: もちろん、このような簡単な例ではrsort()関数 の方がより適しています。

警告

(Solarisシステムのような)いくつかのCライブラリに含まれる quicksort関数は、比較関数が適当な値を返さない場合にPHPをクラッ シュさせる可能性があります。

arsort(), asort(), ksort(), rsort() , sort()も参照下さい。