Funkcia array_multisort

Funkcia array_multisort umožňuje triediť viacero polí súčasne alebo vykonávať zložité triedenie viacrozmerných polí podľa jedného alebo viacerých kritérií.

Syntax

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

Parameter sorting_order

Parameter sorting_order nastavuje smer triedenia. Tu sú jeho hodnoty:

Parameter	Popis
`SORT_ASC`	Triedenie vo vzostupnom poradí (predvolená hodnota).
`SORT_DESC`	Triedenie v zostupnom poradí.

Parameter sorting_type

Parameter sorting_type nastavuje typ porovnania prvkov. Tu sú jeho hodnoty:

Parameter	Popis
`SORT_REGULAR`	Bežné porovnanie prvkov (predvolené).
`SORT_NUMERIC`	Číselné porovnanie prvkov.
`SORT_STRING`	Reťazcové porovnanie prvkov.
`SORT_LOCALE_STRING`	Reťazcové porovnanie s ohľadom na aktuálnu lokalitu.
`SORT_NATURAL`	Prirodzené triedenie reťazcov (ako v priezkumníkovi).
`SORT_FLAG_CASE`	Kombinuje sa s SORT_STRING alebo SORT_NATURAL pre triedenie bez ohľadu na veľkosť písmen.

Príklad

Triedenie dvoch polí so zadaním parametrov:

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

Výsledok vykonania kódu:

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

Príklad

Triedenie viacrozmerného poľa podľa zadaného poľ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);
?>

Výsledok vykonania kódu:

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

Príklad

Triedenie viacrozmerného poľa podľa dvoch zadaných polí:

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

Výsledok vykonania kódu:

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

Príklad

Prirodzené triedenie reťazcov:

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

Výsledok vykonania kódu:

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

Príklad

Triedenie bez ohľadu na veľkosť písmen:

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

Výsledok vykonania kódu:

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

Pozrite tiež

funkciu sort,
ktorá triedi vo vzostupnom poradí prvkov
funkciu rsort,
ktorá triedi v zostupnom poradí prvkov
funkciu ksort,
ktorá triedi vo vzostupnom poradí kľúčov
funkciu krsort,
ktorá triedi v zostupnom poradí kľúčov
funkciu asort,
ktorá triedi vo vzostupnom poradí prvkov so zachovaním kľúčov
funkciu arsort,
ktorá triedi v zostupnom poradí prvkov so zachovaním kľúčov
funkciu natsort,
ktorá triedi prirodzeným spôsobom
funkciu natcasesort,
ktorá triedi prirodzeným spôsobom bez ohľadu na veľkosť písmen
funkciu usort,
ktorá triedi podľa spätného volania
funkciu uksort,
ktorá triedi podľa spätného volania podľa kľúčov
funkciu uasort,
ktorá triedi podľa spätného volania so zachovaním kľúčov