array_multisort
(PHP 4, PHP 5)
array_multisort -- 對多個數組或多維數組進行排序
說明
bool array_multisort ( array ar1 [, mixed arg [, mixed ... [, array ...]]] )
如果成功則返回 TRUE，失敗則返回 FALSE。
array_multisort() 可以用來一次對多個數組進行排序，或者根據某一維或多維對多維數組進行排序。
關聯（string）鍵名保持不變，但數字鍵名會被重新索引。
輸入數組被當成一個表的列並以行來排序――這類似於 SQL 的 ORDER BY 子句的功能。第一個數組是要排序的主要數組。數組中的行（值）比較為相同的話就按照下一個輸入數組中相應值的大小來排序，依此類推。
本函數的參數結構有些不同尋常，但是非常靈活。第一個參數必須是一個數組。接下來的每個參數可以是數組或者是下面列出的排序標志。
排序順序標志：
SORT_ASC - 按照上升順序排序
SORT_DESC - 按照下降順序排序
排序類型標志：
SORT_REGULAR - 將項目按照通常方法比較
SORT_NUMERIC - 將項目按照數值比較
SORT_STRING - 將項目按照字符串比較
每個數組之後不能指定兩個同類的排序標志。每個數組後指定的排序標志僅對該數組有效 - 在此之前為默認值 SORT_ASC 和 SORT_REGULAR。
例子 1. 對多個數組排序
復制代碼 代碼如下:
<?php
$ar1 = array("10", 100, 100, "a");
$ar2 = array(1, 3, "2", 1);
array_multisort($ar1, $ar2);
var_dump($ar1);
var_dump($ar2);
?>
本例中經過排序後，第一個數組將包含 "10"，"a"，100，100。第二個數組將包含 1，1，"2"，3。第二個數組中的項目順序完全和第一個數組中相應的項目（100 和 100）順序一致。
復制代碼 代碼如下:
array(4) {
[0]=> string(2) "10"
[1]=> string(1) "a"
[2]=> int(100)
[3]=> int(100)
}
array(4) {
[0]=> int(1)
[1]=> int(1)
[2]=> string(1) "2"
[3]=> int(3)
}
例子 2. 對多維數組排序
復制代碼 代碼如下:
<?php
$ar = array (array ("10", 100, 100, "a"), array (1, 3, "2", 1));
array_multisort ($ar[0], SORT_ASC, SORT_STRING,
$ar[1], SORT_NUMERIC, SORT_DESC);
?>
本例中經過排序後，第一個數組將包含 10，100，100，"a"（作為字符串上升排序），第二個數組將包含 1，3，"2"，1（作為數值下降排序）。
例子 3. Sorting multi-dimensional array
復制代碼 代碼如下:
<?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)
}
}
例子 4. 對數據庫結果進行排序
本例中 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
例子 5. 不區分大小寫字母排序
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
)
【譯者注】本函數相當有用，為有助於理解，請再看下面這個例子：
例子 6. 名次排列
<?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 分分別用了整數，浮點數和字符串來表示，可以在程序輸出中清楚地看到它們排序的結果。
