Funkcija array_multisort

Funkcija array_multisort omogoča sočasno razvrščanje več polj ali izvajanje kompleksnega razvrščanja večdimenzionalnih polj po enem ali več kriterijih.

Sintaksa

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

Parameter sorting_order

Parameter sorting_order določa smer razvrščanja. Tukaj so njegove vrednosti:

Parameter	Opis
`SORT_ASC`	Razvrščanje naraščajoče (privzeta vrednost).
`SORT_DESC`	Razvrščanje padajoče.

Parameter sorting_type

Parameter sorting_type določa vrsto primerjave elementov. Tukaj so njegove vrednosti:

Parameter	Opis
`SORT_REGULAR`	Običajna primerjava elementov (privzeto).
`SORT_NUMERIC`	Številčna primerjava elementov.
`SORT_STRING`	Nizna primerjava elementov.
`SORT_LOCALE_STRING`	Nizna primerjava ob upoštevanju trenutne lokalizacije.
`SORT_NATURAL`	Naravno razvrščanje nizov (kot v raziskovalcu).
`SORT_FLAG_CASE`	Kombinira se s SORT_STRING ali SORT_NATURAL za razvrščanje neobčutljivo na velikost črk.

Primer

Razvrščanje dveh polj z določitvijo 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);
?>

Rezultat izvajanja kode:

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

Primer

Razvrščanje večdimenzionalnega polja po določenem polju:

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

Rezultat izvajanja kode:

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

Primer

Razvrščanje večdimenzionalnega polja po dveh določenih poljih:

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

Rezultat izvajanja kode:

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

Primer

Naravno razvrščanje nizov:

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

Rezultat izvajanja kode:

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

Primer

Razvrščanje neobčutljivo na velikost črk:

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

Rezultat izvajanja kode:

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

Glejte tudi

funkcijo sort,
ki razvršča naraščajoče po elementih
funkcijo rsort,
ki razvršča padajoče po elementih
funkcijo ksort,
ki razvršča naraščajoče po ključih
funkcijo krsort,
ki razvršča padajoče po ključih
funkcijo asort,
ki razvršča naraščajoče po elementih z ohranjanjem ključev
funkcijo arsort,
ki razvršča padajoče po elementih z ohranjanjem ključev
funkcijo natsort,
ki razvršča naravno
funkcijo natcasesort,
ki razvršča naravno brez upoštevanja velikosti črk
funkcijo usort,
ki razvršča po povratnem klicu
funkcijo uksort,
ki razvršča po povratnem klicu po ključih
funkcijo uasort,
ki razvršča po povratnem klicu z ohranjanjem ključev