Funktionen array_multisort

Funktionen array_multisort tillader dig at sortere flere arrays samtidigt eller udføre komplekse sorteringer af multidimensionelle arrays efter et eller flere kriterier.

Syntaks

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

Parameteren sorting_order

Parameteren sorting_order angiver sorteringsretningen. Her er dens værdier:

Parameter	Beskrivelse
`SORT_ASC`	Sortering i stigende rækkefølge (standardværdi).
`SORT_DESC`	Sortering i faldende rækkefølge.

Parameteren sorting_type

Parameteren sorting_type angiver typen af element sammenligning. Her er dens værdier:

Parameter	Beskrivelse
`SORT_REGULAR`	Almindelig element sammenligning (som standard).
`SORT_NUMERIC`	Numerisk element sammenligning.
`SORT_STRING`	Streng element sammenligning.
`SORT_LOCALE_STRING`	Streng sammenligning under hensyntagen til den aktuelle locale.
`SORT_NATURAL`	Natural streng sortering (som i stifinderen).
`SORT_FLAG_CASE`	Kombineres med SORT_STRING eller SORT_NATURAL for case-insensitiv sortering.

Eksempel

Sortering af to arrays med angivelse af parametre:

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

Resultat af kode udførelse:

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

Eksempel

Sortering af et multidimensionelt array efter et givet felt:

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

Resultat af kode udførelse:

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

Eksempel

Sortering af et multidimensionelt array efter to givne felter:

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

Resultat af kode udførelse:

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

Eksempel

Natural streng sortering:

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

Resultat af kode udførelse:

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

Eksempel

Case-insensitiv sortering:

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

Resultat af kode udførelse:

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

Se også

funktionen sort,
som sorterer i stigende rækkefølge af elementer
funktionen rsort,
som sorterer i faldende rækkefølge af elementer
funktionen ksort,
som sorterer i stigende rækkefølge af nøgler
funktionen krsort,
som sorterer i faldende rækkefølge af nøgler
funktionen asort,
som sorterer i stigende rækkefølge af elementer med bevarelse af nøgler
funktionen arsort,
som sorterer i faldende rækkefølge af elementer med bevarelse af nøgler
funktionen natsort,
som sorterer på natural måde
funktionen natcasesort,
som sorterer på natural måde uden case
funktionen usort,
som sorterer efter callback
funktionen uksort,
som sorterer efter callback på nøgler
funktionen uasort,
som sorterer efter callback med bevarelse af nøgler