Funcția array_multisort

Funcția array_multisort permite sortarea mai multor array-uri simultan sau efectuarea unei sortări complexe a array-urilor multidimensionale după unul sau mai multe criterii.

Sintaxă

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

Parametrul sorting_order

Parametrul sorting_order stabilește direcția de sortare. Iată valorile sale:

Parametru Descriere
SORT_ASC Sortare crescătoare (valoare implicită).
SORT_DESC Sortare descrescătoare.

Parametrul sorting_type

Parametrul sorting_type stabilește tipul de comparare a elementelor. Iată valorile sale:

Parametru Descriere
SORT_REGULAR Comparare obișnuită a elementelor (implicit).
SORT_NUMERIC Comparare numerică a elementelor.
SORT_STRING Comparare șir de caractere a elementelor.
SORT_LOCALE_STRING Comparare șir de caractere ținând cont de locale-ul curent.
SORT_NATURAL Sortare naturală a șirurilor (ca în explorer).
SORT_FLAG_CASE Se combină cu SORT_STRING sau SORT_NATURAL pentru sortare insensibilă la majuscule/minuscule.

Exemplu

Sortarea a două array-uri cu specificarea parametrilor:

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);
?>

Rezultatul executării codului:

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

Exemplu

Sortarea unui array multidimensional după câmpul specificat:

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);
?>

Rezultatul executării codului:

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

Exemplu

Sortarea unui array multidimensional după două câmpuri specificate:

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);
?>

Rezultatul executării codului:

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

Exemplu

Sortarea naturală a șirurilor:

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

Rezultatul executării codului:

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

Exemplu

Sortare insensibilă la majuscule/minuscule:

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

Rezultatul executării codului:

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

Vezi și

  • funcția sort,
    care sortează în ordine crescătoare a elementelor
  • funcția rsort,
    care sortează în ordine descrescătoare a elementelor
  • funcția ksort,
    care sortează în ordine crescătoare a cheilor
  • funcția krsort,
    care sortează în ordine descrescătoare a cheilor
  • funcția asort,
    care sortează în ordine crescătoare a elementelor cu păstrarea cheilor
  • funcția arsort,
    care sortează în ordine descrescătoare a elementelor cu păstrarea cheilor
  • funcția natsort,
    care sortează în mod natural
  • funcția natcasesort,
    care sortează în mod natural fără distincție între majuscule și minuscule
  • funcția usort,
    care sortează după un callback
  • funcția uksort,
    care sortează după un callback după chei
  • funcția uasort,
    care sortează după un callback cu păstrarea cheilor