usort

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 も参照下さい。