rsort

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

rsort — Ordena un array en orden decreciente

Descripción

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

Ordena array en el lugar según los valores en orden decreciente.

Nota:
Si dos miembros se comparan como iguales, ellos mantendrán su orden original. Antes de PHP 8.0.0, su orden relativo en un array ordenado era indefinido.

Nota: Esta función asigna nuevas clave a los elementos del array. Eliminará cualquier clave existente que haya sido asignada, en lugar de reordenar las claves.

Nota:
Reinicia el puntero interno del array al primer elemento.

Parámetros

array

El array de entrada.

flags

The optional second parameter flags may be used to modify the sorting behavior using these values:

Sorting type flags:

SORT_REGULAR - compare items normally; the details are described in the comparison operators section
SORT_NUMERIC - compare items numerically
SORT_STRING - compare items as strings
SORT_LOCALE_STRING - compare items as strings, based on the current locale. It uses the locale, which can be changed using setlocale()
SORT_NATURAL - compare items as strings using "natural ordering" like natsort()
SORT_FLAG_CASE - can be combined (bitwise OR) with SORT_STRING or SORT_NATURAL to sort strings case-insensitively

Valores devueltos

Siempre devuelve true.

Historial de cambios

Versión	Descripción
8.2.0	The return type is `true` now; previously, it was bool.

Ejemplos

Ejemplo #1 Ejemplo con rsort()

<?php
$fruits = array("lemon", "orange", "banana", "apple");
rsort($fruits);
foreach ($fruits as $key => $val) {
    echo "$key = $val\n";
}
?>

El resultado del ejemplo sería:

0 = orange
1 = lemon
2 = banana
3 = apple

Las frutas han sido clasificadas en orden alfabético inverso.

Ver también

sort() - Ordena un array en orden creciente
arsort() - Ordena un array en orden descendente y conserva la asociación de los índices
krsort() - Ordena un array según las claves en orden descendente
comparación de funciones de orden de arrays

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 3 notes

down

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
   }
?>

down

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.

down

-4

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.

＋add a note