uasort

(PHP 4, PHP 5, PHP 7, PHP 8)

uasort — 使用用户定义的比较函数对数组进行排序并保持索引关联

说明

uasort(array &$array, callable $callback): true

本函数对 array 本身排序并保持索引和单元之间的关联。

主要用于对那些单元顺序很重要的结合数组进行排序。比较函数是用户自定义的。

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

注意:
重置数组中的内部指针，指向第一个元素。

参数

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

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

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

返回值

总是返回 true。

更新日志

版本	说明
8.2.0	现在返回类型为 `true`；之前是 bool。
8.0.0	如果 `callback` 接受引用传递参数，该方法将会抛出 `E_WARNING`。

示例

示例 #1 uasort() 的基本示例

<?php
// 比较函数
function cmp($a, $b) {
    if ($a == $b) {
        return 0;
    }
    return ($a < $b) ? -1 : 1;
}

// 要排序的数组
$array = array('a' => 4, 'b' => 8, 'c' => -1, 'd' => -9, 'e' => 2, 'f' => 5, 'g' => 3, 'h' => -4);
print_r($array);

// 排序并打印排序后的数组
uasort($array, 'cmp');
print_r($array);
?>

以上示例会输出：

Array
(
    [a] => 4
    [b] => 8
    [c] => -1
    [d] => -9
    [e] => 2
    [f] => 5
    [g] => 3
    [h] => -4
)
Array
(
    [d] => -9
    [h] => -4
    [c] => -1
    [e] => 2
    [g] => 3
    [a] => 4
    [f] => 5
    [b] => 8
)

参见

usort() - 使用用户自定义的比较函数对数组中的值进行排序
uksort() - 使用用户自定义的比较函数对数组中的键名进行排序
数组排序函数对比

改进此页面

了解如何改进此页面 • 提交拉取请求 • 报告一个错误

＋添加备注

用户贡献的备注 3 notes

down

153

magikMaker ¶

14 years ago

a quick reminder on the syntax if you want to use uasort in a Class or Object:



<?php



// procedural:

uasort($collection, 'my_sort_function');



// Object Oriented

uasort($collection, array($this, 'mySortMethod'));



// Objet Oriented with static method

uasort($collection, array('self', 'myStaticSortMethod'));



?>

down

yannick dot battail at gmail dot com ¶

14 years ago

An Example using anonymous function.
Anonymous functions make some time the code easier to understand.
<?php
$fruits = array('Orange9','Orange11','Orange10','Orange6','Orange15');
uasort ( $fruits , function ($a, $b) {
            return strnatcmp($a,$b); // or other function/code
        }
    );
print_r($fruits);
?>
returns
Array
(
    [3] => Orange6
    [0] => Orange9
    [2] => Orange10
    [1] => Orange11
    [4] => Orange15
)

down

php at eden2 dot com ¶

21 years ago

Is it just me, or are the examples below misleading, and actually demonstrating situations that would be more appropriate for usort()?

After trying to make sense of the uasort() description, it sounds like it's more for sorting a 1D array like this:

"john" => "$23.12"
"tim" => "$6.50"
"bob" => "$18.54"

and getting back:

"tim" => "$6.50"
"bob" => "$18.54"
"john" => $23.12"

(assuming, of course, that your sort function is lopping off the $ and evaluating as a number -- which would complicate the use of asort() ;)