Trie un tableau

# sort

(PHP 4, PHP 5, PHP 7)

sort — Trie un tableau

### Description

sort ( array `&$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.

### 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) avec `SORT_STRING` ou `SORT_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";
}
?>`

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().

### Notes

> 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.

Avertissement

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
- rsort() - Trie un tableau en ordre inverse
- Les fonctions de tri des tableaux