uasort

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

    uasort — Sort an array with a user-defined comparison function and maintain index association

    Опис

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

    Sorts array in place such that its keys maintain their correlation with the values they are associated with, using a user-defined comparison function.

    This is used mainly when sorting associative arrays where the actual element order is significant.

    Зауваження:

    Якщо два члени порівняння однакові, їхній порядок зберігається. До PHP 8.0.0, їхній відносний порядок у впорядкованому масиві був невизначеним.

    Зауваження:

    Скидає внутрішній вказівник масиву на перший елемент.

    Параметри

    array

    The input array.

    callback

    Порівняльна функція має повертати ціле число, котре менше, рівне або більше нуля, якщо перший параметр вважається відповідно меншим, рівним або більшим за другий.

    callback(mixed $a, mixed $b): int
    Застереження

    Якщо функція порівняння повертає не цілі значення, такі як float, вони будуть приведені до типу int під час повернення з функції зворотнього виклику. Тож значення, схожі на 0.99 або 0.1 будуть приведені до цілого 0, отже члени порівняння вважатимуться однаковими.

    Значення, що повертаються

    Завжди повертає true.

    Журнал змін

    Версія Опис
    8.2.0 Тепер повертається значення типу true. До цього був bool.
    8.0.0 Тепер функція видасть E_WARNING, якщо callback очікує параметр за посиланням.

    Приклади

    Приклад #1 Basic uasort() example

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

    // Array to be sorted
    $array = array('a' => 4, 'b' => 8, 'c' => -1, 'd' => -9, 'e' => 2, 'f' => 5, 'g' => 3, 'h' => -4);
    print_r($array);

    // Sort and print the resulting 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
)

    Прогляньте також

    Improve This Page

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋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
    34
    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
    3
    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
    To Top