Fonction array_multisort

La fonction array_multisort permet de trier plusieurs tableaux simultanément ou d'effectuer un tri complexe de tableaux multidimensionnels selon un ou plusieurs critères.

Syntaxe

phparray_multisort(
  array1, 
  [sorting_order = SORT_ASC], 
  [sorting_type = SORT_REGULAR], 
  array2, 
  array3, 
  ...
);

Paramètre sorting_order

Le paramètre sorting_order définit la direction du tri. Voici ses valeurs :

Paramètre Description
SORT_ASC Tri ascendant (valeur par défaut).
SORT_DESC Tri descendant.

Paramètre sorting_type

Le paramètre sorting_type définit le type de comparaison des éléments. Voici ses valeurs :

Paramètre Description
SORT_REGULAR Comparaison normale des éléments (par défaut).
SORT_NUMERIC Comparaison numérique des éléments.
SORT_STRING Comparaison chaîne de caractères des éléments.
SORT_LOCALE_STRING Comparaison chaîne de caractères selon les paramètres régionaux.
SORT_NATURAL Tri naturel des chaînes (comme dans l'explorateur de fichiers).
SORT_FLAG_CASE Se combine avec SORT_STRING ou SORT_NATURAL pour un tri insensible à la casse.

Exemple

Tri de deux tableaux avec spécification des paramètres :

php<?php
  $numbers = [10, 2, 15, 4];
  $letters = ['b', 'a', 'd', 'c'];
  array_multisort(
    $numbers, SORT_DESC, SORT_NUMERIC,
    $letters, SORT_ASC, SORT_STRING
  );
  print_r($numbers);
  print_r($letters);
?>

Résultat de l'exécution du code :

php[15, 10, 4, 2]
['d', 'b', 'c', 'a']

Exemple

Tri d'un tableau multidimensionnel par un champ donné :

php<?php
  $data = [
    ['name' => 'John', 'age' => 25],
    ['name' => 'Alice', 'age' => 22],
    ['name' => 'Bob', 'age' => 30]
  ];
  
  $ages = array_column($data, 'age');
  array_multisort($ages, SORT_ASC, $data);
  print_r($data);
?>

Résultat de l'exécution du code :

php[
  ['name' => 'Alice', 'age' => 22],
  ['name' => 'John', 'age' => 25],
  ['name' => 'Bob', 'age' => 30]
]

Exemple

Tri d'un tableau multidimensionnel par deux champs donnés :

php<?php
  $data = [
    ['name' => 'John', 'age' => 25],
    ['name' => 'alice', 'age' => 22],
    ['name' => 'Bob', 'age' => 30]
  ];
  
  $names = array_column($data, 'name');
  $ages = array_column($data, 'age');
  array_multisort(
    $names, SORT_ASC, SORT_STRING | SORT_FLAG_CASE,
    $ages, SORT_DESC,
    $data
  );
  print_r($data);
?>

Résultat de l'exécution du code :

php[
  ['name' => 'alice', 'age' => 22],
  ['name' => 'Bob', 'age' => 30],
  ['name' => 'John', 'age' => 25]
]

Exemple

Tri naturel des chaînes :

php<?php
  $files = ['file1.txt', 'file10.txt', 'file2.txt'];
  array_multisort($files, SORT_ASC, SORT_NATURAL);
  print_r($files);
?>

Résultat de l'exécution du code :

php['file1.txt', 'file2.txt', 'file10.txt']

Exemple

Tri insensible à la casse :

php<?php
  $words = ['Apple', 'banana', 'cherry', 'apricot'];
  array_multisort($words, SORT_ASC, SORT_STRING | SORT_FLAG_CASE);
  print_r($words);
?>

Résultat de l'exécution du code :

php['Apple', 'apricot', 'banana', 'cherry']

Voir aussi

  • la fonction sort,
    qui trie par ordre croissant des éléments
  • la fonction rsort,
    qui trie par ordre décroissant des éléments
  • la fonction ksort,
    qui trie par ordre croissant des clés
  • la fonction krsort,
    qui trie par ordre décroissant des clés
  • la fonction asort,
    qui trie par ordre croissant des éléments en préservant les clés
  • la fonction arsort,
    qui trie par ordre décroissant des éléments en préservant les clés
  • la fonction natsort,
    qui trie de manière naturelle
  • la fonction natcasesort,
    qui trie de manière naturelle insensible à la casse
  • la fonction usort,
    qui trie avec une fonction de rappel
  • la fonction uksort,
    qui trie avec une fonction de rappel sur les clés
  • la fonction uasort,
    qui trie avec une fonction de rappel en préservant les clés