(PHP 4, PHP 5)
sort — Trie un tableau
&$array
[, int $sort_flags
= SORT_REGULAR
] )
Cette fonction trie le tableau array
. Les
éléments seront triés du plus petit au plus grand.
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) avec SORT_STRING
ou
SORT_NATURAL
pour trier les chaînes sans tenant
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 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.
Attention lorsque vous triez des tableaux avec des types différents de valeurs car le résultat de sort() est imprévisible.