# uksort

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

uksort — Ordena 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

- usort() - Ordena un array según sus valores usando una función de comparación definida por el usuario
- comparación de funciones de orden de arrays