ArrayObject::uksort

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

ArrayObject::uksort — Ordena los elementos por clave con una función utilitaria

Descripción

public function ArrayObject::uksort(callable $callback): true

Esta función ordena las claves de los elementos utilizando una función utilitaria de comparación. La correlación entre las claves y los elementos se conserva.

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.
function callback(mixed $a, mixed $b): int

Precaución
Devolver valores no enteros (como float) desde la función de comparación resultará en una conversión interna del valor de retorno de la retrollamada a int. Así, valores como 0.99 y 0.1 serán convertidos ambos al valor entero 0, por lo que se compararán 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::uksort()

<?php
function cmp($a, $b) {
    $a = preg_replace('@^(le|la|les|un|une|des) @', '', $a);
    $b = preg_replace('@^(le|la|les|un|une|des) @', '', $b);
    return strcasecmp($a, $b);
}

$array = array("Jean" => 1, "la Terre" => 2, "une pomme" => 3, "une banane" => 4);
$arrayObject = new ArrayObject($array);
$arrayObject->uksort('cmp');

foreach ($arrayObject as $key => $value) {
    echo "$key: $value\n";
}
?>

El ejemplo anterior mostrará:

une banane: 4
Jean: 1
une pomme: 3
la Terre: 2

Véase 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::uasort() - Ordena los elementos con una función de usuario
uksort() - Ordena un array por sus claves 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

There are no user contributed notes for this page.