uksort

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

uksortOrdena un array según sus claves usando una función de comparación definida por el usuario

Descripción

uksort(array &$array, callable $key_compare_func): bool

uksort() ordenará las claves de un array usando una función de comparación proporcionada por el usuario. Si el array que se desea ordenar necesita ser ordenado por algún criterio no trivial, debería usar esta función.

Nota:

Si dos miembros se comparan como iguales, su orden relativo en el array oredenado será indefinido.

Parámetros

array

El array de entrada.

key_compare_func

La función de comparación debe devolver un entero menor, igual o mayor que cero si el primer argumento se considera que sea respectivamente menor, igual o mayor que el segundo. Observe que antes de PHP 7.0.0 este entero debía estar en el rango de -2147483648 a 2147483647.

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

Valores devueltos

Devuelve true en caso de éxito o false en caso de error.

Ejemplos

Ejemplo #1 Ejemplo de uksort()

<?php
function cmp($a$b)
{
    
$a preg_replace('@^(un|una|la) @'''$a);
    
$b preg_replace('@^(un|una|la) @'''$b);
    return 
strcasecmp($a$b);
}

$a = array("Víctor" => 1"la Tierra" => 2"una manzana" => 3"un plátano" => 4);

uksort($a"cmp");

foreach (
$a as $clave => $valor) {
    echo 
"$clave$valor\n";
}
?>

El resultado del ejemplo sería:

una manzana: 3
un plátano: 4
la Tierra: 2
Víctor: 1

Ver también