Edit Report a Bug

    rsort

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

    rsort — Сортирует массив в порядке убывания

    Описание

    rsort(array &$array, int $flags = SORT_REGULAR): true

    Сортирует массив (array) по значениям в порядке убывания.

    Замечание:

    Функция сохраняет первоначальный порядок элементов, если при сравнении значения двух элементов равны. До PHP 8.0.0 порядок элементов в отсортированном массиве оставался неопределённым.

    Замечание: Эта функция присваивает новые ключи элементам array. Она удалит все существующие ключи, а не просто переупорядочит их.

    Замечание:

    Сбрасывает внутренний указатель массива на первый элемент.

    Список параметров

    array

    Входной массив.

    flags

    Необязательный второй параметр flags изменяет поведение сортировки и может принимать следующие значения:

    Флаги типов сортировки:

    • SORT_REGULAR — обычное сравнение элементов; подробности описаны в разделе операторы сравнения
    • SORT_NUMERIC — числовое сравнение элементов
    • SORT_STRING — строковое сравнение элементов
    • SORT_LOCALE_STRING — сравнение элементов как строк на основе текущего языкового стандарта. Флаг использует языковой стандарт, который можно изменить функцией setlocale()
    • SORT_NATURAL — сравнение элементов как строки, используя "естественный порядок", например natsort()
    • SORT_FLAG_CASE — можно объединять (побитовое ИЛИ) с SORT_STRING или SORT_NATURAL для сортировки строк без учёта регистра

    Возвращаемые значения

    Функция всегда возвращает true.

    Список изменений

    Версия Описание
    8.2.0 Тип возвращаемого значения теперь true; ранее было bool.

    Примеры

    Пример #1 Пример использования функции rsort()

    <?php

    $fruits     = array("лимон", "апельсин", "банан", "яблоко");
    rsort($fruits);
    foreach (    $fruits as $key => $val) {
    echo     "$key = $val\n";
    }
    ?>

    Результат выполнения приведённого примера: 

    0 = апельсин
1 = лимон
2 = банан
3 = яблоко

    Названия фруктов были отсортированы по алфавиту в обратном порядке.

    Смотрите также

    add a note add a note

    User Contributed Notes 6 notes

    up
    3
    Alex M
    19 years ago
    A cleaner (I think) way to sort a list of files into reversed order based on their modification date.

    <?php
       $path     = $_SERVER[DOCUMENT_ROOT]."/files/";
           $dh = @opendir($path);

       while (    false !== ($file=readdir($dh)))
       {
          if (    substr($file,0,1)!=".")
                 $files[]=array(filemtime($path.$file),$file);   #2-D array
           }
           closedir($dh);

       if (    $files)
       {
              rsort($files); #sorts by filemtime

          #done! Show the files sorted by modification date
              foreach ($files as $file)
             echo     "$file[0] $file[1]<br>\n";  #file[0]=Unix timestamp; file[1]=filename
           }
    ?>
    up
    2
    ray at non-aol dot com
    20 years ago
    Like sort(), rsort() assigns new keys for the elements in array. It will remove any existing keys you may have assigned, rather than just reordering the keys.  This means that it will destroy associative keys.

    $animals = array("dog"=>"large",  "cat"=>"medium",  "mouse"=>"small");
    print_r($animals);
    //Array ( [dog] => large [cat] => medium [mouse] => small )

    rsort($animals);
    print_r($animals);
    //Array ( [0] => small [1] => medium [2] => large )

    Use KSORT() or KRSORT() to preserve associative keys.
    up
    -2
    pshirkey at boosthardware dot com
    19 years ago
    I needed a function that would sort a list of files into reversed order based on their modification date.

    Here's what I came up with:

    function display_content($dir,$ext){

        $f = array();
        if (is_dir($dir)) {
            if ($dh = opendir($dir)) {
                while (($folder = readdir($dh)) !== false) {
                    if (preg_match("/\s*$ext$/", $folder)) {
                        $fullpath = "$dir/$folder";
                        $mtime = filemtime ($fullpath);
                   
                        $ff = array($mtime => $fullpath);
                        $f = array_merge($f, $ff);
                          
                }            
                    }

               

                rsort($f, SORT_NUMERIC);

                while (list($key, $val) = each($f)) {
                    $fcontents = file($val, "r");
                    while (list($key, $val) = each($fcontents))
                        echo "$val\n";
                }

            }
        }
           
            closedir($dh);
    }

    Call it like so:

    display_content("folder","extension");
    up
    -3
    slevy1 at pipeline dot com
    23 years ago
    I thought rsort was working successfully or on a multi-dimensional array of strings that had first been sorted with usort(). But, I noticed today that the array  was only partially in descending order.  I tried array_reverse on it and that seems to have solved things.
    up
    -7
    rnk-php at kleckner dot net
    21 years ago
    Apparently rsort does not put arrays with one value back to zero.  If you have an array like: $tmp = array(9 => 'asdf') and then rsort it, $tmp[0] is empty and $tmp[9] stays as is.
    up
    -9
    suniafkhami at gmail dot com
    10 years ago
    If you are sorting an array from a database result set, such as MySQL for example, another approach could be to have your database sort the result set by using ORDER BY DESC, which would be the equivalent of using rsort() on the resulting array in PHP.

    [Edited by moderator for clarity: googleguy at php dot net]
    add a note add a note
    To Top