array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.arsort.php', 1 => 'arsort', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Funções para Array', ), 'prev' => array ( 0 => 'function.array.php', 1 => 'array', ), 'next' => array ( 0 => 'function.asort.php', 1 => 'asort', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/array/functions/arsort.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
arsort — Ordena um array em ordem descrescente e mantém a associação de índices
Ordena o array
em ordem decrescente,
de forma que suas chaves mantenham suas correlações com os valores
aos quais estão associadas.
É usada principalmente para ordenar arrays associativos onde a ordem dos elementos é um fator significativo.
Nota:
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.
Nota:
Redefine o ponteiro interno do array para o primeiro elemento.
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) com
SORT_STRING
ou
SORT_NATURAL
para ordenar strings sem fazer distinção entre maiúsculas e minúsculas
Sempre retorna true
.
Versão | Descrição |
---|---|
8.2.0 |
O tipo do retorno agora é true ; anteriormente, era bool.
|
Exemplo #1 Exemplo de arsort()
<?php
$frutas = array("d" => "limão", "a" => "laranja", "b" => "banana", "c" => "maçã");
arsort($frutas);
foreach ($frutas as $chave => $valor) {
echo "$chave = $valor\n";
}
?>
O exemplo acima produzirá:
c = maçã d = limao a = laranja b = banana
As frutas foram ordenadas na ordem alfabética inversa, e os índices associados a cada elemento foram mantidos.