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.
Note : Si deux éléments sont égaux, au sens de la fonction
cmp_function
, leur ordre sera indéfini. Jusqu'en PHP 4.0.6, la fonction de tri leur conserverait leur ordre original, mais le nouvel algorithme introduit en PHP 4.1.0 fait que ce n'est plus le cas, car cela serait trop coûteux.
Note : Cette fonction assigne de nouvelles clés pour les éléments du paramètre
array
. Elle effacera toutes les clés existantes que vous aviez pû assigner, plutôt que de réordonner les clés.
Cette fonction retourne TRUE en cas de succès, FALSE en cas d'échec.
Note : Évidemment dans ce cas trivial, rsort() serait plus approprié.
Exemple 3. Tri avec usort() sur un objet
L'exemple ci-dessus va afficher :
|
Voir aussi uasort(), uksort(), sort(), asort(), arsort(), ksort(), natsort() et rsort().
Précédent | Sommaire | Suivant |
uksort | Niveau supérieur | Aspell (Obsolète) |