Funkcija array_multisort

Funkcija array_multisort leidžia vienu metu rūšiuoti kelis masyvus arba atlikti sudėtingą daugiamačių masyvų rūšiavimą pagal vieną ar kelis kriterijus.

Sintaksė

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

Parametras sorting_order

Parametras sorting_order nustato rūšiavimo kryptį. Štai jo reikšmės:

Parametras	Aprašas
`SORT_ASC`	Rūšiavimas didėjimo tvarka (numatytoji reikšmė).
`SORT_DESC`	Rūšiavimas mažėjimo tvarka.

Parametras sorting_type

Parametras sorting_type nustato elementų palyginimo tipą. Štai jo reikšmės:

Parametras	Aprašas
`SORT_REGULAR`	Įprastinis elementų palyginimas (pagal nutylėjimą).
`SORT_NUMERIC`	Skaitinis elementų palyginimas.
`SORT_STRING`	Eilučių elementų palyginimas.
`SORT_LOCALE_STRING`	Eilučių palyginimas atsižvelgiant į dabartinę lokalę.
`SORT_NATURAL`	Natūralus eilučių rūšiavimas (kaip naršyklėje).
`SORT_FLAG_CASE`	Kombinuojamas su SORT_STRING arba SORT_NATURAL registro nepaisančiam rūšiavimui.

Pavyzdys

Dviejų masyvų rūšiavimas nurodant parametrus:

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

Kodo vykdymo rezultatas:

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

Pavyzdys

Daugiamačio masyvo rūšiavimas pagal nurodytą lauką:

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

Kodo vykdymo rezultatas:

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

Pavyzdys

Daugiamačio masyvo rūšiavimas pagal du nurodytus laukus:

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

Kodo vykdymo rezultatas:

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

Pavyzdys

Natūralus eilučių rūšiavimas:

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

Kodo vykdymo rezultatas:

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

Pavyzdys

Registro nepaisantis rūšiavimas:

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

Kodo vykdymo rezultatas:

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

Taip pat žiūrėkite

funkciją sort,
kuri rūšiuoja pagal elementų didėjimą
funkciją rsort,
kuri rūšiuoja pagal elementų mažėjimą
funkciją ksort,
kuri rūšiuoja pagal raktų didėjimą
funkciją krsort,
kuri rūšiuoja pagal raktų mažėjimą
funkciją asort,
kuri rūšiuoja pagal elementų didėjimą išsaugant raktus
funkciją arsort,
kuri rūšiuoja pagal elementų mažėjimą išsaugant raktus
funkciją natsort,
kuri rūšiuoja natūraliu būdu
funkciją natcasesort,
kuri rūšiuoja natūraliu būdu neatsižvelgiant į registrą
funkciją usort,
kuri rūšiuoja pagal callback funkciją
funkciją uksort,
kuri rūšiuoja pagal callback funkciją pagal raktus
funkciją uasort,
kuri rūšiuoja pagal callback funkciją išsaugant raktus