usort

Descripción

Esta función ordenará una matriz por sus valores usando una función de comparación definida por el usuario. Si la matriz que desea ordenar necesita ser ordenada mediante ciertos criterios especiales, es buena idea usar esta función.

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

Devuelve TRUE si todo se llevó a cabo correctamente, FALSE en caso de fallo.

Ejemplo 1. Ejemplo de usort() <?php function cmp($a, $b) {     if ($a == $b) {         return 0;     }     return ($a < $b) ? -1 : 1; } $a = array(3, 2, 5, 6, 1); usort($a, "cmp"); while (list($clave, $valor) = each($a)) {     echo "$clave: $valor\n"; } ?> Este ejemplo produciría la salida: 0: 1 1: 2 2: 3 3: 5 4: 6

Ejemplo 2. Ejemplo de usort() usando una matriz multi-dimensional <?php function cmp($a, $b) {     return strcmp($a["fruta"], $b["fruta"]); } $frutas[0]["fruta"] = "limones"; $frutas[1]["fruta"] = "bananos"; $frutas[2]["fruta"] = "granadillas"; usort($frutas, "cmp"); while (list($clave, $valor) = each($frutas)) {     echo "\$frutas[$clave]: " . $valor["fruta"] . "\n"; } ?> Cuando se ordena una matriz multi-dimensional, $a y $b contienen referencias al primer índice de la matriz. Este ejemplo produciría la salida: $frutas[0]: bananos $frutas[1]: granadillas $frutas[2]: limones

Ejemplo 3. Ejemplo de usort() usando una función miembro de un objeto <?php class ObjPrueba {     var $nombre;     function ObjPrueba($nombre)     {         $this->nombre = $nombre;     }     /* Esta es la funcion estatica de comparacion: */     function cmp_obj($a, $b)     {         $al = strtolower($a->nombre);         $bl = strtolower($b->nombre);         if ($al == $bl) {             return 0;         }         return ($al > $bl) ? +1 : -1;     } } $a[] = new ObjPrueba("c"); $a[] = new ObjPrueba("b"); $a[] = new ObjPrueba("d"); usort($a, array("ObjPrueba", "cmp_obj")); foreach ($a as $item) {     echo $item->nombre . "\n"; } ?> Este ejemplo produciría la salida: b c d

Vea también uasort(), uksort(), sort(), asort(), arsort(),ksort(), natsort(), and rsort().