Функция array_multisort

Функцията array_multisort позволява едновременно сортиране на няколко масива или извършване на сложно сортиране на многомерни масиви по един или няколко критерия.

Синтаксис

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

Параметър sorting_order

Параметърът sorting_order задава посока на сортиране. Ето неговите стойности:

Параметър Описание
SORT_ASC Сортиране във възходящ ред (стойност по подразбиране).
SORT_DESC Сортиране в низходящ ред.

Параметър sorting_type

Параметърът sorting_type задава тип сравнение на елементите. Ето неговите стойности:

Параметър Описание
SORT_REGULAR Обикновено сравнение на елементи (по подразбиране).
SORT_NUMERIC Числово сравнение на елементи.
SORT_STRING Символено сравнение на елементи.
SORT_LOCALE_STRING Символено сравнение, като се взема предвид текущата локализация.
SORT_NATURAL Естествено сортиране на низове (като в проводника).
SORT_FLAG_CASE Комбинира се с SORT_STRING или SORT_NATURAL за сортиране, независимо от регистъра.

Пример

Сортиране на два масива с указване на параметри:

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

Резултат от изпълнението на кода:

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

Пример

Сортиране на многомерен масив по зададено поле:

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

Резултат от изпълнението на кода:

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

Пример

Сортиране на многомерен масив по две зададени полета:

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

Резултат от изпълнението на кода:

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

Пример

Естествено сортиране на низове:

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

Резултат от изпълнението на кода:

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

Пример

Сортиране, независимо от регистъра:

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

Резултат от изпълнението на кода:

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

Вижте също

  • функцията sort,
    която сортира по възходящ ред на елементите
  • функцията rsort,
    която сортира по низходящ ред на елементите
  • функцията ksort,
    която сортира по възходящ ред на ключовете
  • функцията krsort,
    която сортира по низходящ ред на ключовете
  • функцията asort,
    която сортира по възходящ ред на елементите със запазване на ключовете
  • функцията arsort,
    която сортира по низходящ ред на елементите със запазване на ключовете
  • функцията natsort,
    която сортира по естествен начин
  • функцията natcasesort,
    която сортира по естествен начин без регистър
  • функцията usort,
    която сортира по callback функция
  • функцията uksort,
    която сортира по callback функция по ключове
  • функцията uasort,
    която сортира по callback функция със запазване на ключовете