Funkcija array_multisort

Funkcija array_multisort ļauj vienlaicīgi kārtot vairākus masīvus vai veikt sarežģītu daudzdimensiju masīvu kārtošanu pēc viena vai vairākiem kritērijiem.

Sintakse

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

Parametrs sorting_order

Parametrs sorting_order nosaka kārtošanas virzienu. Šeit ir tā vērtības:

Parametrs	Apraksts
`SORT_ASC`	Kārtošana augošā secībā (noklusējuma vērtība).
`SORT_DESC`	Kārtošana dilstošā secībā.

Parametrs sorting_type

Parametrs sorting_type nosaka elementu salīdzināšanas veidu. Šeit ir tā vērtības:

Parametrs	Apraksts
`SORT_REGULAR`	Parasta elementu salīdzināšana (pēc noklusējuma).
`SORT_NUMERIC`	Skaitliska elementu salīdzināšana.
`SORT_STRING`	Virknes elementu salīdzināšana.
`SORT_LOCALE_STRING`	Virknes salīdzināšana, ņemot vērā pašreizējo lokalizāciju.
`SORT_NATURAL`	Dabiska virkņu kārtošana (kā failu pārlūkā).
`SORT_FLAG_CASE`	Kombinējas ar SORT_STRING vai SORT_NATURAL reģistrjutīgai kārtošanai.

Piemērs

Divu masīvu kārtošana ar parametru norādīšanu:

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

Koda izpildes rezultāts:

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

Piemērs

Daudzdimensiju masīva kārtošana pēc norādītā lauka:

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

Koda izpildes rezultāts:

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

Piemērs

Daudzdimensiju masīva kārtošana pēc diviem norādītiem laukiem:

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

Koda izpildes rezultāts:

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

Piemērs

Dabiska virkņu kārtošana:

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

Koda izpildes rezultāts:

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

Piemērs

Reģistrjutīga kārtošana:

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

Koda izpildes rezultāts:

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

Skatiet arī

funkciju sort,
kas kārto paaugšināti pēc elementiem
funkciju rsort,
kas kārto dilstoši pēc elementiem
funkciju ksort,
kas kārto paaugšināti pēc atslēgām
funkciju krsort,
kas kārto dilstoši pēc atslēgām
funkciju asort,
kas kārto paaugšināti pēc elementiem, saglabājot atslēgas
funkciju arsort,
kas kārto dilstoši pēc elementiem, saglabājot atslēgas
funkciju natsort,
kas kārto dabiskā veidā
funkciju natcasesort,
kas kārto dabiskā veidā bez reģistra
funkciju usort,
kas kārto pēc atsauces
funkciju uksort,
kas kārto pēc atsauces pēc atslēgām
funkciju uasort,
kas kārto pēc atsauces, saglabājot atslēgas