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, mantienen su orden original. Anterior a PHP 8.0.0, su orden relativo en el array ordenado no está definido.

Parámetros

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.

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

Precaución
Retornar valores no-entero desde la función de comparación, tales como float, resultará en una conversión interna del valor de retorno del callback a int. Así, valores tales como 0.99 y 0.1 serán convertidos ambos a un valor entero de 0, lo que comparará tales valores como iguales.

Valores devueltos

Retorna siempre true.

Historial de cambios

Versión	Descripción
8.2.0	El tipo de retorno es ahora `true`, anteriormente era 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 ejemplo anterior mostrará :

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