Ordenar as entradas por valor

Descrição

public ArrayObject::asort(int $flags = SORT_REGULAR): true

Ordena as entradas em ordem crescente, de forma que suas chaves mantenham sua correlação com os valores que estão associados a elas.

Isso é usado principalmente ao ordenar arrays associativos onde a ordem real dos elementos é significativa.

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.

Parâmetros

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

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 ArrayObject::asort()

<?php
$fruits = array("d" => "lemon", "a" => "orange", "b" => "banana", "c" => "apple");
$fruitArrayObject = new ArrayObject($fruits);
$fruitArrayObject->asort();

foreach ($fruitArrayObject as $key => $val) {
    echo "$key = $val\n";
}
?>

O exemplo acima produzirá:

c = apple
b = banana
d = lemon
a = orange

As frutas foram ordenadas em ordem alfabética, e a chave associada a cada entrada foi mantida.

Veja Também

ArrayObject::ksort() - Ordena as entradas pela chave
ArrayObject::natsort() - Ordena as entradas usando um algoritmo de "ordem natural"
ArrayObject::natcasesort() - Ordena uma matriz usando um algoritmo de "ordem natural" insensível a maiúsculas e minúsculas
ArrayObject::uasort() - Ordena as entradas com uma função de comparação definida pelo usuário e mantém a associação de chaves
ArrayObject::uksort() - Ordena as entradas pelas chaves usando uma função de comparação definida pelo usuário
asort() - Ordena um array em ordem crescente e mantém a associação de índices