(PHP 4, PHP 5, PHP 7, PHP 8)
asort — Ordena um array em ordem crescente e mantém a associação de índices
Ordena um array
em ordem crescente, se forma que suas chaves mantenham suas correlações com os valores aos quais estão associadas.
Isto é usado principalmente ao ordenar arrays associativos onde a ordem real dos elementos é significativa.
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çãoSORT_NUMERIC
- compara os elementos numericamenteSORT_STRING
- compara os elementos como stringsSORT_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
.
Exemplo #1 Exemplo de asort()
<?php
$frutas = array("d" => "limão", "a" => "laranja", "b" => "banana", "c" => "maçã");
asort($frutas);
foreach( $frutas as $chave => $valor ){
echo "$chave = $valor\n";
}
?>
O exemplo acima produzirá:
b = banana a = laranja d = limão c = maçã
As frutas foram ordenadas na ordem alfabética, e os índices associados a cada elemento foram mantidos.