ArrayIterator::uasort

ユーザー定義の比較関数を使ってソートを行い、インデックスとの関連を管理する

説明

public true ArrayIterator::uasort(callable $callback)

この関数は、ユーザー定義の比較関数を使って 関連している値とインデックスの関係を管理する方法で、要素をソートします。

注意:

比較結果が等しくなる二つの要素があった場合、それらの並び順は保持されます。PHP 8.0.0 より前のバージョンでは、ソートした配列におけるそれらの並び順は不定でした。

パラメータ

callback

比較関数は、最初の引数と二番目の引数の比較結果を返します。最初の引数のほうが二番目の引数より大きい場合は正の整数を、二番目の引数と等しい場合はゼロを、そして二番目の引数より小さい場合は負の整数を返す必要があります。

int callback(mixed $a, mixed $b)
警告

float のような 非整数 を比較関数が返すと、その返り値を内部的に int にキャストして使います。 つまり、0.990.1 といった値は整数値 0 にキャストされ、 値が等しいとみなされます。

戻り値

常に true を返します。

変更履歴

バージョン 説明
8.2.0 戻り値の型が、true になりました。これより前のバージョンでは、bool でした。

参考

  • ArrayIterator::asort
  • ArrayIterator::ksort
  • ArrayIterator::natcasesort
  • ArrayIterator::natsort
  • ArrayIterator::uksort
  • uasort