ArrayIterator::uasort

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

ArrayIterator::uasort — Sort with a user-defined comparison function and maintain index association

说明

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

This method sorts the elements such that indices maintain their correlation with the values they are associated with, using a user-defined comparison function.

注意:
如果两个成员完全相同，那么它们将保持原来的顺序。在 PHP 8.0.0 之前，它们在排序数组中的相对顺序是未定义的。

参数

callback: 在第一个参数小于，等于或大于第二个参数时，该比较函数必须相应地返回一个小于，等于或大于 0 的整数。

callback(mixed $a, mixed $b): int

警告
从比较函数中返回非整数值，例如 float，将导致内部强制转换为 callback 返回值为 int。因此，诸如 0.99 和 0.1 之类的值都将被转换为整数值 0，将这些值比较的话将会是相等。

返回值

总是返回 true。

更新日志

版本	说明
8.2.0	现在返回类型为 `true`；之前是 bool。

参见

ArrayIterator::asort() - Sort entries by values
ArrayIterator::ksort() - Sort entries by keys
ArrayIterator::natcasesort() - Sort entries naturally, case insensitive
ArrayIterator::natsort() - Sort entries naturally
ArrayIterator::uksort() - Sort by keys using a user-defined comparison function
uasort() - 使用用户定义的比较函数对数组进行排序并保持索引关联

add a note

User Contributed Notes 1 note

down

Massimiliano Arione ¶

8 years ago


Even if documentation says that $cmp_function must be a string, this method works with a Callable also.
Example:

<?php

$iterator->uasort([$this, 'usort']);  // 'usort' here is a method in the same class

add a note