Fungsi array_multisort

Fungsi array_multisort membolehkan penyusunan beberapa array serentak atau melakukan penyusunan kompleks array multidimensi mengikut satu atau beberapa kriteria.

Sintaks

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

Parameter sorting_order

Parameter sorting_order menetapkan arah penyusunan. Berikut adalah nilainya:

Parameter	Keterangan
`SORT_ASC`	Susunan menaik (nilai lalai).
`SORT_DESC`	Susunan menurun.

Parameter sorting_type

Parameter sorting_type menetapkan jenis perbandingan elemen. Berikut adalah nilainya:

Parameter	Keterangan
`SORT_REGULAR`	Perbandingan elemen biasa (lalai).
`SORT_NUMERIC`	Perbandingan elemen berangka.
`SORT_STRING`	Perbandingan elemen rentetan.
`SORT_LOCALE_STRING`	Perbandingan rentetan dengan mengambil kira lokal semasa.
`SORT_NATURAL`	Susunan rentetan semula jadi (seperti dalam penjelajah fail).
`SORT_FLAG_CASE`	Digabungkan dengan SORT_STRING atau SORT_NATURAL untuk penyusunan tidak sensitif huruf.

Contoh

Menyusun dua array dengan menetapkan parameter:

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

Hasil pelaksanaan kod:

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

Contoh

Menyusun array multidimensi mengikut medan yang ditentukan:

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

Hasil pelaksanaan kod:

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

Contoh

Menyusun array multidimensi mengikut dua medan yang ditentukan:

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

Hasil pelaksanaan kod:

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

Contoh

Susunan rentetan semula jadi:

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

Hasil pelaksanaan kod:

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

Contoh

Susunan tidak sensitif huruf:

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

Hasil pelaksanaan kod:

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

Lihat juga

fungsi sort,
yang menyusun mengikut kenaikan elemen
fungsi rsort,
yang menyusun mengikut penurunan elemen
fungsi ksort,
yang menyusun mengikut kenaikan kunci
fungsi krsort,
yang menyusun mengikut penurunan kunci
fungsi asort,
yang menyusun mengikut kenaikan elemen dengan pemeliharaan kunci
fungsi arsort,
yang menyusun mengikut penurunan elemen dengan pemeliharaan kunci
fungsi natsort,
yang menyusun secara semula jadi
fungsi natcasesort,
yang menyusun secara semula jadi tanpa kes sensitif huruf
fungsi usort,
yang menyusun mengikut callback
fungsi uksort,
yang menyusun mengikut callback untuk kunci
fungsi uasort,
yang menyusun mengikut callback dengan pemeliharaan kunci