uasort

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

uasort — Ordena un array utilizando una función de retrollamada

Descripción

Ordena array en el lugar de tal manera que la correlación entre las claves y los valores sea conservada, utilizando una función de comparación definida por el usuario.

Utilizado habitualmente al ordenar arrays asociativos donde el orden actual de los elementos es significativo.

Nota: Si dos miembros se comparan como iguales, mantienen su orden original. Anterior a PHP 8.0.0, su orden relativo en el array ordenado no está definido.

Nota: Reinicia el puntero interno del array al primer elemento.

Parámetros

array

El array de entrada.

callback

La función de comparación debe retornar un entero menor que, igual a, o mayor que 0 si el primer argumento es considerado, respectivamente, menor que, igual a, o mayor que el segundo.

function callback(mixed $a, mixed $b): int

Precaución

Devolver valores no enteros (como float ) desde la función de comparación resultará en una conversión interna del valor de retorno de la retrollamada a int . Así, valores como 0.99 y 0.1 serán convertidos ambos al valor entero 0, por lo que se compararán como iguales.

Valores devueltos

Retorna siempre true .

Historial de cambios

Ejemplos

<?php
// Función de comparación
function cmp($a, $b) {
 if ($a == $b) {
 return 0;
 }
 return ($a < $b) ? -1 : 1;
}
// Array a ordenar
$array = array('a' => 4, 'b' => 8, 'c' => -1, 'd' => -9, 'e' => 2, 'f' => 5, 'g' => 3, 'h' => -4);
print_r($array);
// Ordena y muestra el array resultante
uasort($array, 'cmp');
print_r($array);
?>

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
)

Véase también

• usort() - Ordena un array utilizando una función de comparación
• uksort() - Ordena un array por sus claves utilizando una función de retrollamada
• Las funciones de ordenación de arrays