Funktsioon array_multisort

Funktsioon array_multisort võimaldab korraga sorteerida mitut massiivi või teostada keerukat mitmemõõtmeliste massiivide sorteerimist ühe või mitme kriteeriumi järgi.

Süntaks

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

Parameeter sorting_order

Parameeter sorting_order määrab sorteerimise suuna. Siin on selle väärtused:

Parameeter	Kirjeldus
`SORT_ASC`	Sorteerimine kasvavas järjekorras (vaikeväärtus).
`SORT_DESC`	Sorteerimine kahanevas järjekorras.

Parameeter sorting_type

Parameeter sorting_type määrab elementide võrdluse tüübi. Siin on selle väärtused:

Parameeter	Kirjeldus
`SORT_REGULAR`	Tavaline elementide võrdlus (vaikimisi).
`SORT_NUMERIC`	Arvuline elementide võrdlus.
`SORT_STRING`	Stringide võrdlus.
`SORT_LOCALE_STRING`	Stringide võrdlus, võttes arvesse praegust lokatiivi.
`SORT_NATURAL`	Looduslik stringide sorteerimine (nagu failihalduris).
`SORT_FLAG_CASE`	Kombineeritakse SORT_STRING või SORT_NATURAL-iga tõstutundetu sorteerimise jaoks.

Näide

Kahe massiivi sorteerimine parameetrite määramisega:

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

Koodi täitmise tulemus:

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

Näide

Mitmemõõtmelise massiivi sorteerimine antud välja järgi:

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

Koodi täitmise tulemus:

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

Näide

Mitmemõõtmelise massiivi sorteerimine kahe antud välja järgi:

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

Koodi täitmise tulemus:

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

Näide

Looduslik stringide sorteerimine:

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

Koodi täitmise tulemus:

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

Näide

Tõstutundetu sorteerimine:

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

Koodi täitmise tulemus:

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

Vaata ka

funktsiooni sort,
mis sorteerib elementide kasvavas järjekorras
funktsiooni rsort,
mis sorteerib elementide kahanevas järjekorras
funktsiooni ksort,
mis sorteerib võtmete kasvavas järjekorras
funktsiooni krsort,
mis sorteerib võtmete kahanevas järjekorras
funktsiooni asort,
mis sorteerib elementide kasvavas järjekorras võtmeid säilitades
funktsiooni arsort,
mis sorteerib elementide kahanevas järjekorras võtmeid säilitades
funktsiooni natsort,
mis sorteerib looduslikul viisil
funktsiooni natcasesort,
mis sorteerib looduslikul viisil tõstutundetult
funktsiooni usort,
mis sorteerib callback-funktsiooni järgi
funktsiooni uksort,
mis sorteerib callback-funktsiooni järgi võtmete kaupa
funktsiooni uasort,
mis sorteerib callback-funktsiooni järgi võtmeid säilitades