sort
(PHP 4, PHP 5)
sort — Trie un tableau
Description
&$array
[, int $sort_flags
= SORT_REGULAR
] )
Cette fonction trie le tableau array
. Les
éléments seront triés du plus petit au plus grand.
Liste de paramètres
-
array
-
Le 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) avecSORT_STRING
ouSORT_NATURAL
pour trier les chaînes sans tenir compte de la casse.
-
Valeurs de retour
Cette fonction retourne TRUE
en cas de
succès ou FALSE
si une erreur survient.
Historique
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
|
Exemples
Exemple #1 Exemple avec sort()
<?php
$fruits = array("lemon", "orange", "banana", "apple");
sort($fruits);
foreach ($fruits as $key => $val) {
echo "fruits[" . $key . "] = " . $val . "\n";
}
?>
<?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().
Notes
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 pu assigner, plutôt que de les trier.
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.
Voir aussi
- asort() - Trie un tableau et conserve l'association des index
- Les fonctions de tri des tableaux