usort

Description

usort() va trier le tableau array avec ses valeurs, en utilisant une fonction définie par l'utilisateur. Si un tableau doit être trié avec un critère complexe, il est préférable d'utiliser cette méthode.

La fonction de comparaison cmp_function doit retourner un entier, qui sera inférieur, égal ou supérieur à zéro suivant que le premier argument est considéré comme plus petit, égal ou plus grand que le second argument. Si les deux arguments sont égaux, leur ordre est indéfini.

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

Exemple 1. Exemple avec usort() <?php function compare($a, $b) {     if ($a == $b) {       return 0;     }     return ($a > $b) ? -1 : 1; } $a = array (3, 2, 5, 6, 1); usort ($a, "compare"); foreach ($a as $key => $value) {     echo "$key: $value\n"; } ?> L'exemple ci-dessus va afficher : 0: 6 1: 5 2: 3 3: 2 4: 1

Exemple 2. Tri avec usort() sur un tableau multi-dimensionnel <?php function compare($a, $b) {     return strcmp($a["fruit"], $b["fruit"]); } $fruits[0]["fruit"] = "citron"; $fruits[1]["fruit"] = "pommes"; $fruits[2]["fruit"] = "raisins"; usort($fruits, "compare"); while (list ($key, $value) = each ($fruits)) {     echo "\$fruits[$key]: " . $value["fruit"] . "\n"; } ?> Lors du tri de tableau multi-dimensionnel, $a et $b contiennent des références sur le premier élément du tableau. L'exemple ci-dessus va afficher : $fruits[0]: raisins $fruits[1]: pommes $fruits[2]: citron

Exemple 3. Tri avec usort() sur un objet <?php class TestObj {     var $name;     function TestObj($name)     {         $this->name = $name;     }     /* Ceci est une fonction de comparaison statique */     function cmp_obj($a, $b)     {         $al = strtolower($a->name);         $bl = strtolower($b->name);         if ($al == $bl) {           return 0;         }         return ($al > $bl) ? +1 : -1;     } } $a[] = new TestObj("c"); $a[] = new TestObj("b"); $a[] = new TestObj("d"); uasort($a, array ("TestObj", "cmp_obj")); foreach ($a as $item) {     echo $item->name."\n"; } ?> L'exemple ci-dessus va afficher : b c d

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