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

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

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

    float のような 非整数 を比較関数が返すと、その返り値を内部的に 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
    13 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