rsort
(PHP 4, PHP 5, PHP 7, PHP 8)
rsort — Ordena um array em ordem descrescente
Descrição
Ordena array
pelos valores
em ordem descrescente.
Note:
Se dois elementos são comparados como iguais, eles mantêm sua ordem original. Antes do PHP 8.0.0, sua ordem relativa no array ordenado era indefinida.
Note: Esta função atribui novas chaves aos elementos do
array
. Ela removerá todas as chaves existentes que possam ter sido atribuídas, em vez de apenas reordenar as chaves.
Note:
Redefine o ponteiro interno do array para o primeiro elemento.
Parâmetros
array
-
O array de entrada.
flags
-
O segundo parâmetro opcional
flags
pode ser usado para modificar o comportamento da ordenação usando estes valores:Flags dos tipos de ordenação:
-
SORT_REGULAR
- compara os elementos normalmente; os detalhes são descritos na seção operadores de comparação -
SORT_NUMERIC
- compara os elementos numericamente -
SORT_STRING
- compara os elementos como strings -
SORT_LOCALE_STRING
- compara os elementos como strings, com base na localidade atual. A localidade pode ser alterada usando setlocale() -
SORT_NATURAL
- compara os elementos como strings usando "ordenação natural" como natsort() -
SORT_FLAG_CASE
- pode ser combinada (usando o operador bit a bit OR) comSORT_STRING
ouSORT_NATURAL
para ordenar strings sem fazer distinção entre maiúsculas e minúsculas
-
Valor Retornado
Sempre retorna true
.
Registro de Alterações
Versão | Descrição |
---|---|
8.2.0 |
O tipo do retorno agora é true ; anteriormente, era bool.
|
Exemplos
Example #1 Exemplo de rsort()
<?php
$frutas = array ("limão", "laranja", "banana", "maçã");
rsort ($frutas);
foreach( $frutas as $chave => $valor ){
echo "$chave = $valor\n";
}
?>
O exemplo acima produzirá:
0 = maçã 1 = limão 2 = laranja 3 = banana
As frutas foram ordenadas em ordem alfabética decrescente.
Veja Também
- sort() - Ordena um array em ordem ascendente
- arsort() - Ordena um array em ordem descrescente e mantém a associação de índices
- krsort() - Ordena um array pelas chaves em ordem descrescente
- Comparação entre as funções de ordenação de array