rsort

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

rsort — Sortiert ein Array in absteigender Reihenfolge

Beschreibung

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

Sortiert array nach Werten in absteigender Reihenfolge.

Hinweis:
Wenn zwei Mitglieder als identisch verglichen werden, behalten sie ihre ursprüngliche Reihenfolge bei. Vor PHP 8.0.0 war die relative Sortierung im sortierten Array nicht definiert.

Hinweis: Diese Funktion weist den Elementen des Arrays array neue Schlüssel zu. Bestehende Schlüssel, die bereits zugewiesen wurden, werden entfernt statt einfach nur die Schlüssel neu anzuordnen

Hinweis:
Setzt den internen Zeiger des Arrays auf das erste Element zurück.

Parameter-Liste

array

Das Eingabe-Array.

flags

Der optionale zweite Parameter flags kann mit folgenden Werten genutzt werden, um das Sortierverhalten zu ändern:

Flags für den Sortiertyp:

SORT_REGULAR - vergleicht Elemente normal; die Details werden im Abschnitt Vergleichsoperatoren beschrieben.
SORT_NUMERIC - vergleicht Elemente numerisch.
SORT_STRING - vergleicht Elemente als Zeichenketten.
SORT_LOCALE_STRING - vergleicht Elemente als Zeichenketten, basierend auf dem aktuellen Gebietsschema. Es wird das Gebietsschema verwendet, das mit setlocale() geändert werden kann.
SORT_NATURAL - vergleicht Elemente als Zeichenketten wie natsort() mit "natürlicher Ordnung".
SORT_FLAG_CASE - kann kombiniert werden (bitweise ODER) mit SORT_STRING oder SORT_NATURAL, um Zeichenketten ohne Berücksichtigung der Groß- und Kleinschreibung zu sortieren.

Rückgabewerte

Gibt immer true zurück.

Changelog

Version	Beschreibung
8.2.0	Der Rückgabewert ist nun `true` vorher war es bool.

Beispiele

Beispiel #1 rsort()-Beispiel

<?php
$fruits = array("Orange", "Apfel", "Zitrone", "Banane");
rsort($fruits);
foreach ($fruits as $key => $val) {
    echo "$key = $val\n";
}
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

0 = Zitrone
1 = Orange
2 = Banane
3 = Apfel

Die Früchte wurden in umgekehrter alphabetischer Reihenfolge sortiert.

Siehe auch

sort() - Sortiert ein Array in aufsteigender Reihenfolge
arsort() - Sortiert ein Array in absteigender Reihenfolge und behält die Indexzuordnung bei
krsort() - Sortiert ein Array nach Schlüsseln in absteigender Reihenfolge
Den Vergleich von Arraysortierungsfunktionen

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