Функцыя 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,
    якая сортирует па зваротнай функцыі
  • функцыю uksort,
    якая сортирует па зваротнай функцыі па ключах
  • функцыю uasort,
    якая сортирует па зваротнай функцыі з захаваннем ключоў