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

# ArrayIterator::uasort

(PHP 5 >= 5.2.0, PHP 7, PHP 8)

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

### 説明

public function ArrayIterator::uasort(callable `$callback`): true

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

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

### パラメータ

`callback`
  比較関数は、最初の引数と二番目の引数の比較結果を返します。最初の引数のほうが二番目の引数より大きい場合は正の整数を、二番目の引数と等しい場合はゼロを、そして二番目の引数より小さい場合は負の整数を返す必要があります。
  function callback(mixed `$a`, mixed `$b`): int
  警告

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

### 戻り値

常に `true` を返します。

### 変更履歴

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

### 参考

- ArrayIterator::asort() - 値で配列をソートする
- ArrayIterator::ksort() - キーで配列をソートする
- ArrayIterator::natcasesort() - 大文字小文字を区別せずに自然順で配列をソートする
- ArrayIterator::natsort() - 自然順で配列をソートする
- ArrayIterator::uksort() - ユーザー定義の比較関数を使い、キーでソートする
- uasort() - ユーザー定義の比較関数で配列をソートし、連想インデックスを保持する

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open