Funkcja array_multisort

Funkcja array_multisort pozwala sortować wiele tablic jednocześnie lub wykonywać złożone sortowanie tablic wielowymiarowych według jednego lub wielu kryteriów.

Składnia

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

Parametr sorting_order

Parametr sorting_order określa kierunek sortowania. Oto jego wartości:

Parametr	Opis
`SORT_ASC`	Sortowanie rosnąco (wartość domyślna).
`SORT_DESC`	Sortowanie malejąco.

Parametr sorting_type

Parametr sorting_type określa typ porównania elementów. Oto jego wartości:

Parametr	Opis
`SORT_REGULAR`	Zwykłe porównanie elementów (domyślnie).
`SORT_NUMERIC`	Numeryczne porównanie elementów.
`SORT_STRING`	Porównanie łańcuchowe elementów.
`SORT_LOCALE_STRING`	Porównanie łańcuchowe z uwzględnieniem bieżącej lokalizacji.
`SORT_NATURAL`	Naturalne sortowanie ciągów (jak w eksploratorze plików).
`SORT_FLAG_CASE`	Łączone z SORT_STRING lub SORT_NATURAL dla sortowania niewrażliwego na wielkość liter.

Przykład

Sortowanie dwóch tablic z określeniem parametrów:

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

Wynik wykonania kodu:

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

Przykład

Sortowanie tablicy wielowymiarowej według określonego pola:

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

Wynik wykonania kodu:

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

Przykład

Sortowanie tablicy wielowymiarowej według dwóch określonych pól:

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

Wynik wykonania kodu:

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

Przykład

Naturalne sortowanie ciągów:

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

Wynik wykonania kodu:

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

Przykład

Sortowanie niewrażliwe na wielkość liter:

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

Wynik wykonania kodu:

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

Zobacz też

funkcję sort,
która sortuje rosnąco według elementów
funkcję rsort,
która sortuje malejąco według elementów
funkcję ksort,
która sortuje rosnąco według kluczy
funkcję krsort,
która sortuje malejąco według kluczy
funkcję asort,
która sortuje rosnąco według elementów z zachowaniem kluczy
funkcję arsort,
która sortuje malejąco według elementów z zachowaniem kluczy
funkcję natsort,
która sortuje w sposób naturalny
funkcję natcasesort,
która sortuje w sposób naturalny bez uwzględniania wielkości liter
funkcję usort,
która sortuje według funkcji zwrotnej
funkcję uksort,
która sortuje według funkcji zwrotnej po kluczach
funkcję uasort,
która sortuje według funkcji zwrotnej z zachowaniem kluczy