Edit Report a Bug

    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
)

    参见

    add a note add a note

    User Contributed Notes 3 notes

    up
    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'));

    ?>
    up
    32
    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
    )
    up
    2
    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() ;)
    add a note add a note
    To Top