(PHP 4, PHP 5, PHP 7)
sort — Trie un tableau
&$array
[, int $sort_flags = SORT_REGULAR
] ) : bool
Cette fonction trie le tableau array. Les
éléments seront triés du plus petit au plus grand.
Note:
Si deux membres se comparent comme égaux, leur ordre relatif dans le tableau trié n'est pas défini.
arrayLe tableau d'entrée.
sort_flags
Le paramètre optionnel sort_flags
peut être utilisé pour modifier le comportement de tri en
utilisant ces valeurs :
Constantes de type de tri :
SORT_REGULAR : compare les éléments normalement
(ne modifie pas les types)
SORT_NUMERIC : compare les éléments numériquement
SORT_STRING : compare les éléments comme des chaînes
de caractères
SORT_LOCALE_STRING : compare les éléments
en utilisant la configuration locale.
La locale courante est utilisée, elle peut être changée au moyen de setlocale().
SORT_NATURAL - compare les éléments
comme des chaînes de caractères en utilisant l'ordre nature comme le
fait la fonction natsort().
SORT_FLAG_CASE - peut être combiné (grâce à
l'opérateur OR) avec SORT_STRING ou
SORT_NATURAL pour trier les chaînes sans tenir
compte de la casse.
Cette fonction retourne TRUE en cas de succès ou FALSE si une erreur survient.
| Version | Description |
|---|---|
| 5.4.0 |
Ajout du support des constantes SORT_NATURAL et
SORT_FLAG_CASE pour le paramètre
sort_flags
|
| 5.0.2 |
Ajout de la constante SORT_LOCALE_STRING
|
Exemple #1 Exemple avec sort()
<?php
$fruits = array("lemon", "orange", "banana", "apple");
sort($fruits);
foreach ($fruits as $key => $val) {
echo "fruits[" . $key . "] = " . $val . "\n";
}
?>
L'exemple ci-dessus va afficher :
fruits[0] = apple fruits[1] = banana fruits[2] = lemon fruits[3] = orange
Les fruits ont été classés dans l'ordre alphabétique.
Exemple #2 Exemple avec sort() en utilisant l'ordre naturel sans tenir compte de la casse
<?php
$fruits = array(
"Orange1", "orange2", "Orange3", "orange20"
);
sort($fruits, SORT_NATURAL | SORT_FLAG_CASE);
foreach ($fruits as $key => $val) {
echo "fruits[" . $key . "] = " . $val . "\n";
}
?>
L'exemple ci-dessus va afficher :
fruits[0] = Orange1 fruits[1] = orange2 fruits[2] = Orange3 fruits[3] = orange20
Les fruits ont été classés comme ils l'auraient été avec la fonction natcasesort().
Note: Cette fonction assigne de nouvelles clés aux éléments dans
array. Elle effacera toutes les clés existantes qui ont pu être assignées, plutôt que de réarranger les clés.
Note: Comme la plupart des fonctions de tri de PHP, sort() utilise une implémentation de » Quicksort. Le pivot est choisie au milieu de la partition, résultant ainsi en une optimisation du temps pour les tableaux déjà triés. Mais ceci ne reste qu'un détail de l'implémentation, n'ayant aucun impact pour vous.
Attention lorsque vous triez des tableaux avec des types différents de valeurs car le résultat de sort() est imprévisible.