ArrayObject::uasort

(PHP 5 >= 5.2.0, PHP 7, PHP 8)

ArrayObject::uasort — Ordena los elementos con una función de usuario

Descripción

public ArrayObject::uasort(callable $callback): true

Esta función ordena los elementos manteniendo su correlación con la clave asociada, utilizando una función de comparación de usuario.

Esta función se utiliza al ordenar arrays asociativos, donde el orden de los elementos es importante.

Nota:
Si dos miembros se comparan como iguales, ellos mantendrán su orden original. Antes de PHP 8.0.0, su orden relativo en un array ordenado era indefinido.

Parámetros

callback: 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

Precaución
Returning non-integer values from the comparison function, such as float, will result in an internal cast to int of the callback's return value. So values such as 0.99 and 0.1 will both be cast to an integer value of 0, which will compare such values as equal.

Valores devueltos

Siempre devuelve true.

Historial de cambios

Versión	Descripción
8.2.0	The return type is `true` now; previously, it was bool.

Ejemplos

Ejemplo #1 Ejemplo con ArrayObject::uasort()

<?php
// Función de comparación
function cmp($a, $b) {
    if ($a == $b) {
        return 0;
    }
    return ($a < $b) ? -1 : 1;
}

// Los arrays a ordenar
$array = array('a' => 4, 'b' => 8, 'c' => -1, 'd' => -9, 'e' => 2, 'f' => 5, 'g' => 3, 'h' => -4);
$arrayObject = new ArrayObject($array);
var_dump($arrayObject);

// Ordena y muestra el array
$arrayObject->uasort('cmp');
var_dump($arrayObject);
?>

El resultado del ejemplo sería:

object(ArrayObject)#1 (1) {
  ["storage":"ArrayObject":private]=>
  array(8) {
    ["a"]=>
    int(4)
    ["b"]=>
    int(8)
    ["c"]=>
    int(-1)
    ["d"]=>
    int(-9)
    ["e"]=>
    int(2)
    ["f"]=>
    int(5)
    ["g"]=>
    int(3)
    ["h"]=>
    int(-4)
  }
}
object(ArrayObject)#1 (1) {
  ["storage":"ArrayObject":private]=>
  array(8) {
    ["d"]=>
    int(-9)
    ["h"]=>
    int(-4)
    ["c"]=>
    int(-1)
    ["e"]=>
    int(2)
    ["g"]=>
    int(3)
    ["a"]=>
    int(4)
    ["f"]=>
    int(5)
    ["b"]=>
    int(8)
  }
}

Ver también

ArrayObject::asort() - Ordena los elementos por valor
ArrayObject::ksort() - Ordena un array por clave
ArrayObject::natsort() - Ordena los elementos con un tri natural
ArrayObject::natcasesort() - Ordena un array utilizando el ordenamiento natural sin distinción de mayúsculas y minúsculas
ArrayObject::uksort() - Ordena los elementos por clave con una función utilitaria
uasort() - Ordena un array utilizando una función de retrollamada

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 1 note

down

poxetinho at gmail dot com ¶

13 years ago

Note that return values between (-1, 1) are being considered as 0.

＋add a note