Rechercher une fonction PHP

sort

(PHP 4, PHP 5, PHP 7)

sortTrie un tableau

Description

bool sort ( array &$array [, int $sort_flags = SORT_REGULAR ] )

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($fruitsSORT_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.

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

Rechercher une fonction PHP

Version en cache

05/11/2024 16:22:37 Cette version de la page est en cache (à la date du 05/11/2024 16:22:37) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.

Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-function.sort.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

  1. Consulter le document html Langue du document :fr Manuel PHP : http://php.net

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut