array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'arrayobject.uasort.php', 1 => 'ArrayObject::uasort', ), 'up' => array ( 0 => 'class.arrayobject.php', 1 => 'ArrayObject', ), 'prev' => array ( 0 => 'arrayobject.setiteratorclass.php', 1 => 'ArrayObject::setIteratorClass', ), 'next' => array ( 0 => 'arrayobject.uksort.php', 1 => 'ArrayObject::uksort', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/spl/arrayobject/uasort.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 5 >= 5.2.0, PHP 7, PHP 8)
ArrayObject::uasort — Ordena as entradas com uma função de comparação definida pelo usuário e mantém a associação de chaves
Esta função ordena as entradas de forma que as chaves mantenham sua correlação com a entrada à qual estão associadas, usando uma função de comparação definida pelo usuário.
Isso é 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.
callback
A função de comparação deve retornar um inteiro menor que, igual ou maior que zero se o primeiro argumento for considerado respectivamente menor que, igual ou maior que o segundo.
Sempre retorna true
.
Versão | Descrição |
---|---|
8.2.0 |
O tipo do retorno agora é true ; anteriormente, era bool.
|
Exemplo #1 Exemplo de ArrayObject::uasort()
<?php
// Função de comparação
function cmp($a, $b) {
if ($a == $b) {
return 0;
}
return ($a < $b) ? -1 : 1;
}
// Array a ser ordenado
$array = array('a' => 4, 'b' => 8, 'c' => -1, 'd' => -9, 'e' => 2, 'f' => 5, 'g' => 3, 'h' => -4);
$arrayObject = new ArrayObject($array);
print_r($arrayObject);
// Ordena e imprime o array resultante
$arrayObject->uasort('cmp');
print_r($arrayObject);
?>
O exemplo acima produzirá:
Array ( [a] => 4 [b] => 8 [c] => -1 [d] => -9 [e] => 2 [f] => 5 [g] => 3 [h] => -4 ) Array ( [d] => -9 [h] => -4 [c] => -1 [e] => 2 [g] => 3 [a] => 4 [f] => 5 [b] => 8 )