rsort
(PHP 4, PHP 5, PHP 7)
rsort — Sort an array in reverse order
Description
rsort ( array &$array [, int $flags = SORT_REGULAR ] ) : bool
This function sorts an array in reverse order (highest to lowest).
Note:
If two members compare as equal, their relative order in the sorted array is undefined.
Parameters
-
array
-
The input array.
-
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) withSORT_STRING
orSORT_NATURAL
to sort strings case-insensitively
-
Return Values
Returns true
on success or false
on failure.
Examples
Example #1 rsort() example
<?php $fruits = array("lemon", "orange", "banana", "apple"); rsort($fruits); foreach ($fruits as $key => $val) { echo "$key = $val\n"; } ?>
The above example will output:
0 = orange 1 = lemon 2 = banana 3 = apple
The fruits have been sorted in reverse alphabetical order.
Notes
Note: This function assigns new keys to the elements in
array
. It will remove any existing keys that may have been assigned, rather than just reordering the keys.
See Also
- arsort() - Sort an array in reverse order and maintain index association
- krsort() - Sort an array by key in reverse order
- The comparison of array sorting functions
© 1997–2020 The PHP Documentation Group
Licensed under the Creative Commons Attribution License v3.0 or later.
https://www.php.net/manual/en/function.rsort.php