usort

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

説明

void usort(array array, function cmp_function);

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

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

例 1. usort() の例

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

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

警告

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

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