array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.asort.php', 1 => 'asort', 2 => 'Ordena um array em ordem crescente e mantém a associação de índices', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Funções para Array', ), 'prev' => array ( 0 => 'function.arsort.php', 1 => 'arsort', ), 'next' => array ( 0 => 'function.compact.php', 1 => 'compact', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/array/functions/asort.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

asort

(PHP 4, PHP 5, PHP 7, PHP 8)

asort — Ordena um array em ordem crescente e mantém a associação de índices

Descrição

asort(array &$array, int $flags = SORT_REGULAR): true

Ordena um array em ordem crescente, se forma que as 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.

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:

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

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.

Veja Também