PHP array_multisort()Fonctions

PHP Array ReferenceRéférence complète des tableaux PHP

Exemples

Renvoie un tableau trié par ordre croissant :

<?php
$a=array("Dog","Cat","Horse","Bear","Zebra");
array_multisort($a);
print_r($a);
?>

Exécuter l'exemple »

Définition et utilisation

La fonction array_multisort() renvoie un tableau trié. Vous pouvez saisir un ou plusieurs tableaux. La fonction trie d'abord le premier tableau, puis les autres tableaux. Si deux valeurs ou plus sont identiques, elle trie le tableau suivant.

Remarque :Les clés de type chaîne seront conservées, mais les clés numériques seront réindexées, à partir de 0 et en augmentant de 1.

Remarque :Vous pouvez définir les paramètres d'ordre de tri et de type de tri après chaque tableau. S'ils ne sont pas définis, chaque paramètre de tableau utilisera la valeur par défaut.

Syntaxe

array_multisort(array1,ordre de tri,type de tri,array2,array3...)

Paramètre Description
array1 Obligatoire. Spécifie un tableau.
ordre de tri Facultatif. Spécifie l'ordre de tri. Valeurs possibles :
  • SORT_ASC - Par défaut. Trie par ordre croissant (A-Z).
  • SORT_DESC - Trie par ordre décroissant (Z-A).
type de tri Facultatif. Spécifie le type de tri. Valeurs possibles :
  • SORT_REGULAR - Par défaut. Classe chaque élément dans l'ordre normal (ASCII standard, sans modifier les types).
  • SORT_NUMERIC - Traite chaque élément comme un nombre.
  • SORT_STRING - Traiter chaque élément comme une chaîne.
  • SORT_LOCALE_STRING - Traiter chaque élément comme une chaîne, en fonction de la locale actuelle (quesetlocale()peut modifier).
  • SORT_NATURAL - Traiter chaque élément comme une chaîne, en utilisant un ordre naturel similaire ànatsort()natsort().
  • SORT_FLAG_CASE - Peut être combiné (OU bit à bit) avec SORT_STRING ou SORT_NATURAL pour trier les chaînes sans tenir compte de la casse.
array2 Facultatif. Spécifie un tableau.
array3 Facultatif. Spécifie un tableau.

Détails techniques

Valeur de retour : Retourne TRUE en cas de succès, ou FALSE en cas d'échec.
Version PHP : 4+
Journal des modifications : Les types de tri SORT_NATURAL et SORT_FLAG_CASE ont été ajoutés dans PHP 5.4.

Le type de tri SORT_LOCALE_STRING a été ajouté dans PHP 5.3.

Plus d’exemples

Exemple 1

Renvoie un tableau trié par ordre croissant :

<?php
$a1=array("Dog","Cat");
$a2=array("Fido","Missy");
array_multisort($a1,$a2);
print_r($a1);
print_r($a2);
?>

Exécuter l'exemple »

Exemple 2

Comment trier lorsque deux valeurs sont identiques :

<?php
$a1=array("Dog","Dog","Cat");
$a2=array("Pluto","Fido","Missy");
array_multisort($a1,$a2);
print_r($a1);
print_r($a2);
?>

Exécuter l'exemple »

Exemple 3

Utilisation des paramètres de tri :

<?php
$a1=array("Dog","Dog","Cat");
$a2=array("Pluto","Fido","Missy");
array_multisort($a1,SORT_ASC,$a2,SORT_DESC);
print_r($a1);
print_r($a2);
?>

Exécuter l'exemple »

Exemple 4

Fusionner deux tableaux et trier par ordre numérique décroissant :

<?php
$a1=array(1,30,15,7,25);
$a2=array(4,30,20,41,66);
$num=array_merge($a1,$a2);
array_multisort($num,SORT_DESC,SORT_NUMERIC);
print_r($num);
?>

Exécuter l'exemple »

PHP Array ReferenceRéférence complète des tableaux PHP Autres extensions