uksort

(PHP 3 >= 3.0.4, PHP 4, PHP 5)

uksort -- Trie un tableau par ses clés en utilisant une fonction de callback

Description

bool uksort ( array &array, callback cmp_function )

uksort() trie les clés du tableau array en utilisant la fonction utilisateur cmp_function. Si un tableau doit être trié avec un critère complexe, il est préférable d'utiliser uksort().

La fonction cmp_function doit accepter deux paramètres, qui représenteront une paire de clés du tableau array. La fonction de comparaison doit retourner un entier supérieur, égal ou inférieur à zéro, pour, respectivement, indiquer que le premier argument est supérieur, égal ou inférieur au second.

Cette fonction retourne TRUE en cas de succès, FALSE en cas d'échec.

Exemple 1. Exemple avec uksort()

<?php
function compare ($a, $b) {
     
$a = ereg_replace('^(a|an|the) ', '', $a);
     
$b = ereg_replace('^(a|an|the) ', '', $b);
     return
strcasecmp($a, $b);
}

$a = array("John" => 1, "the Earth" => 2, "an apple" => 3, "a banana" => 4);

uksort ($a, "compare");

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

L'exemple ci-dessus va afficher :

an apple: 3
a banana: 4
the Earth: 2
John: 1

Voir aussi usort(), uasort(), sort(), asort(), arsort(), ksort(), natsort() et rsort().