Funkce array_multisort

Funkce array_multisort umožňuje řadit více polí současně nebo provádět složité řazení vícerozměrných polí podle jednoho nebo více kritérií.

Syntaxe

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

Parametr sorting_order

Parametr sorting_order nastavuje směr řazení. Zde jsou jeho hodnoty:

Parametr	Popis
`SORT_ASC`	Řazení vzestupně (výchozí hodnota).
`SORT_DESC`	Řazení sestupně.

Parametr sorting_type

Parametr sorting_type nastavuje typ porovnání prvků. Zde jsou jeho hodnoty:

Parametr	Popis
`SORT_REGULAR`	Běžné porovnání prvků (výchozí).
`SORT_NUMERIC`	Číselné porovnání prvků.
`SORT_STRING`	Řetězcové porovnání prvků.
`SORT_LOCALE_STRING`	Řetězcové porovnání s ohledem na aktuální lokalitu.
`SORT_NATURAL`	Přirozené řazení řetězců (jako v průzkumníku).
`SORT_FLAG_CASE`	Kombinuje se s SORT_STRING nebo SORT_NATURAL pro řazení nezávislé na velikosti písmen.

Příklad

Řazení dvou polí s uvedením parametrů:

<?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ýsledek provedení kódu:

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

Příklad

Řazení vícerozměrného pole podle zadaného pole:

<?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ýsledek provedení kódu:

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

Příklad

Řazení vícerozměrného pole podle dvou 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ýsledek provedení kódu:

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

Příklad

Přirozené řazení řetězců:

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

Výsledek provedení kódu:

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

Příklad

Řazení nezávislé na velikosti písmen:

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

Výsledek provedení kódu:

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

Viz také

funkci sort,
která řadí vzestupně podle prvků
funkci rsort,
která řadí sestupně podle prvků
funkci ksort,
která řadí vzestupně podle klíčů
funkci krsort,
která řadí sestupně podle klíčů
funkci asort,
která řadí vzestupně podle prvků se zachováním klíčů
funkci arsort,
která řadí sestupně podle prvků se zachováním klíčů
funkci natsort,
která řadí přirozeným způsobem
funkci natcasesort,
která řadí přirozeným způsobem bez ohledu na velikost písmen
funkci usort,
která řadí pomocí callback funkce
funkci uksort,
která řadí pomocí callback funkce podle klíčů
funkci uasort,
která řadí pomocí callback funkce se zachováním klíčů