Функцыя array_multisort

Функцыя array_multisort дазваляе сартаваць некалькі масіваў адначасова або вырабляць складанае сартаванне шматмерных масіваў па адным або некалькіх крытэрыях.

Сінтаксіс

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

Вынік выканання кода:

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

Прыклад

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

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

Вынік выканання кода:

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

Прыклад

Сартаванне шматмернага масіва па двух зададзеных палях:

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

Вынік выканання кода:

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

Прыклад

Натуральная сартоўка радкоў:

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

Вынік выканання кода:

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

Прыклад

Рэгістранезалежная сартоўка:

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

Вынік выканання кода:

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

Глядзіце таксама

функцыю sort,
якая сортирует па ўзрастанні элементаў
функцыю rsort,
якая сортирует па ўбыванні элементаў
функцыю ksort,
якая сортирует па ўзрастанні ключоў
функцыю krsort,
якая сортирует па ўбыванні ключоў
функцыю asort,
якая сортирует па ўзрастанні элементаў з захаваннем ключоў
функцыю arsort,
якая сортирует па ўбыванні элементаў з захаваннем ключоў
функцыю natsort,
якая сортирует натуральным чынам
функцыю natcasesort,
якая сортирует натуральным чынам без рэгістру
функцыю usort,
якая сортирует па зваротнай функцыі
функцыю uksort,
якая сортирует па зваротнай функцыі па ключах
функцыю uasort,
якая сортирует па зваротнай функцыі з захаваннем ключоў