(PHP 4, PHP 5)
array_multisort — 對多個數組或多維數組進行排序
&$arr [, mixed $arg = SORT_ASC [, mixed $arg = SORT_REGULAR [, mixed $... ]]] )
array_multisort() 可以用來一次對多個數組進行排序，或者根據某一維或多維對多維數組進行排序。
關聯（string）鍵名保持不變，但數字鍵名會被重新索引。
排序順序標志：
SORT_ASC - 按照上升順序排序 SORT_DESC - 按照下降順序排序 排序類型標志：
SORT_REGULAR - 將項目按照通常方法比較 SORT_NUMERIC - 將項目按照數值比較 SORT_STRING - 將項目按照字符串比較 每個數組之後不能指定兩個同類的排序標志。每個數組後指定的排序標志僅對該數組有效 - 在此之前為默認值 SORT_ASC 和 SORT_REGULAR。
輸入數組被當成一個表的列並以行來排序——這類似於 SQL 的 ORDER BY 子句的功能。第一個數組是要排序的主要數組。數組中的行（值）比較為相同的話就按照下一個輸入數組中相應值的大小來排序，依此類推。
本函數的參數結構有些不同尋常，但是非常靈活。第一個參數必須是一個數組。接下來的每個參數可以是數組或者是下面列出的排序標志。
arr
要排序的一個 array。
arg
接下來的每個參數可以是另一個 array 或者是為之前 array 排序標志選項參數： SORT_ASC, SORT_DESC, SORT_REGULAR, SORT_NUMERIC, SORT_STRING.
...
Additional arg's.
成功時返回 TRUE， 或者在失敗時返回 FALSE。
Example #1 Sorting multiple arrays
<?php
$ar1 = array(10, 100, 100, 0);
$ar2 = array(1, 3, 2, 4);
array_multisort($ar1, $ar2);
var_dump($ar1);
var_dump($ar2);
?>
In this example, after sorting, the first array will contain 0, 10, 100, 100. The second array will contain 4, 1, 2, 3. The entries in the second array corresponding to the identical entries in the first array (100 and 100) were sorted as well.
array(4) {
[0]=> int(0)
[1]=> int(10)
[2]=> int(100)
[3]=> int(100)
}
array(4) {
[0]=> int(4)
[1]=> int(1)
[2]=> int(2)
[3]=> int(3)
}
Example #2 排序多維數組
<?php
$ar = array(
array("10", 11, 100, 100, "a"),
array( 1, 2, "2", 3, 1)
);
array_multisort($ar[0], SORT_ASC, SORT_STRING,
$ar[1], SORT_NUMERIC, SORT_DESC);
var_dump($ar);
?>
本例中在排序後，第一個數組將變成 "10"，100，100，11，"a"（被當作字符串以升序排列）。第二個數組將包含 1, 3, "2", 2, 1（被當作數字以降序排列）。
array(2) {
[0]=> array(5) {
[0]=> string(2) "10"
[1]=> int(100)
[2]=> int(100)
[3]=> int(11)
[4]=> string(1) "a"
}
[1]=> array(5) {
[0]=> int(1)
[1]=> int(3)
[2]=> string(1) "2"
[3]=> int(2)
[4]=> int(1)
}
}
Example #3 對數據庫結果進行排序
本例中 data 數組中的每個單元表示一個表中的一行。這是典型的數據庫記錄的數據集合。
例子中的數據如下：
volume | edition
-------+--------
67 | 2
86 | 1
85 | 6
98 | 2
86 | 6
67 | 7
數據全都存放在名為 data 的數組中。這通常是通過循環從數據庫取得的結果，例如 mysql_fetch_assoc()。
<?php
$data[] = array('volume' => 67, 'edition' => 2);
$data[] = array('volume' => 86, 'edition' => 1);
$data[] = array('volume' => 85, 'edition' => 6);
$data[] = array('volume' => 98, 'edition' => 2);
$data[] = array('volume' => 86, 'edition' => 6);
$data[] = array('volume' => 67, 'edition' => 7);
?>
本例中將把 volume 降序排列，把 edition 升序排列。
現在有了包含有行的數組，但是 array_multisort() 需要一個包含列的數組，因此用以下代碼來取得列，然後排序。
<?php
// 取得列的列表
foreach ($data as $key => $row) {
$volume[$key] = $row['volume'];
$edition[$key] = $row['edition'];
}
// 將數據根據 volume 降序排列，根據 edition 升序排列
// 把 $data 作為最後一個參數，以通用鍵排序
array_multisort($volume, SORT_DESC, $edition, SORT_ASC, $data);
?>
數據集合現在排好序了，結果如下：
volume | edition
-------+--------
98 | 2
86 | 1
86 | 6
85 | 6
67 | 2
67 | 7
Example #4 不區分大小寫字母排序
SORT_STRING 和 SORT_REGULAR 都是區分大小寫字母的，大寫字母會排在小寫字母之前。
要進行不區分大小寫的排序，就要按照原數組的小寫字母拷貝來排序。
<?php
$array = array('Alpha', 'atomic', 'Beta', 'bank');
$array_lowercase = array_map('strtolower', $array);
array_multisort($array_lowercase, SORT_ASC, SORT_STRING, $array);
print_r($array);
?>
以上例程會輸出：
Array
(
[0] => Alpha
[1] => atomic
[2] => bank
[3] => Beta
)
【譯者注】本函數相當有用，為有助於理解，請再看下面這個例子：
Example #5 名次排列
<?php
$grade = array("score" => array(70, 95, 70.0, 60, "70"),
"name" => array("Zhang San", "Li Si", "Wang Wu",
"Zhao Liu", "Liu Qi"));
array_multisort($grade["score"], SORT_NUMERIC, SORT_DESC,
// 將分數作為數值，由高到低排序
$grade["name"], SORT_STRING, SORT_ASC);
// 將名字作為字符串，由小到大排序
var_dump($grade);
?>
以上例程會輸出：
array(2) {
["score"]=>
array(5) {
[0]=>
int(95)
[1]=>
string(2) "70"
[2]=>
float(70)
[3]=>
int(70)
[4]=>
int(60)
}
["name"]=>
array(5) {
[0]=>
string(5) "Li Si"
[1]=>
string(6) "Liu Qi"
[2]=>
string(7) "Wang Wu"
[3]=>
string(9) "Zhang San"
[4]=>
string(8) "Zhao Liu"
}
}
本例中對包含成績的數組 $grade 按照分數（score）由高到低進行排序，分數相同的人則按照名字（name）由小到大排序。排序後李四 95 分為第一名，趙六 60 分為第五名沒有異議。張三、王五和劉七都是 70 分，他們的名次則由其姓名的字母順序排列，Liu 在前，Wang 在後而 Zhang 在最後。為了區別，三個 70 分分別用了整數，浮點數和字符串來表示，可以在程序輸出中清楚地看到它們排序的結果。
*
