(PHP 4, PHP 5, PHP 7, PHP 8)
array_multisort — 對多個(gè)數組或多維數組進(jìn)行排序
&$array1
,$array1_sort_order
= SORT_ASC,$array1_sort_flags
= SORT_REGULAR,...$rest
array_multisort() 可以用來(lái)一次對多個(gè)數組進(jìn)行排序,或者根據某一維或多維對多維數組進(jìn)行排序。
關(guān)聯(lián)(string)鍵名保持不變,但數字鍵名會(huì )被重新索引。
注意:
如果兩個(gè)成員完全相同,那么它們將保持原來(lái)的順序。 在 PHP 8.0.0 之前,它們在排序數組中的相對順序是未定義的。
注意:
重置數組中的內部指針,指向第一個(gè)元素。
array1
要排序的 array。
array1_sort_order
之前 array 參數要排列的順序。
SORT_ASC
按照上升順序排序, SORT_DESC
按照下降順序排序。
此參數可以和 array1_sort_flags
互換,也可以完全刪除,默認是 SORT_ASC
。
array1_sort_flags
為 array 參數設定選項:
排序類(lèi)型標志:
SORT_REGULAR
-
將項目按照通常方法比較(不修改類(lèi)型)
SORT_NUMERIC
- 按照數字大小比較
SORT_STRING
- 按照字符串比較
SORT_LOCALE_STRING
- 根據當前的本地化設置,按照字符串比較。
它會(huì )使用 locale 信息,可以通過(guò) setlocale() 修改此信息。
SORT_NATURAL
- 以字符串的"自然排序",類(lèi)似 natsort()
SORT_FLAG_CASE
- 可以組合
(按位或 OR)
SORT_STRING
或者
SORT_NATURAL
大小寫(xiě)不敏感的方式排序字符串。
參數可以和 array1_sort_order
交換或者省略,默認情況下是 SORT_REGULAR
。
rest
可選的選項,可提供更多數組,跟隨在 sort order 和 sort flag 之后。 提供的數組和之前的數組要有相同數量的元素。 換言之,排序是按字典順序排列的。
成功時(shí)返回 true
, 或者在失敗時(shí)返回 false
。
示例 #1 多個(gè)數組排序
<?php
$ar1 = array(10, 100, 100, 0);
$ar2 = array(1, 3, 2, 4);
array_multisort($ar1, $ar2);
var_dump($ar1);
var_dump($ar2);
?>
這個(gè)例子里,排序后,第一個(gè)數組會(huì )包含 0、 10、 100、 100。 第二個(gè)數組會(huì )包含 4、1、 2、 3。 第二個(gè)數組里的項目對應第一個(gè)數組后也進(jìn)行了排序(100 和 100)。
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) }
示例 #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);
?>
本例中在排序后,第一個(gè)數組將變成 "10",100,100,11,"a"(被當作字符串以升序排列)。第二個(gè)數組將包含 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) } }
示例 #3 對數據庫結果進(jìn)行排序
本例中 data 數組中的每個(gè)單元表示一個(gè)表中的一行。這是典型的數據庫記錄的數據集合。
例子中的數據如下:
volume | edition -------+-------- 67 | 2 86 | 1 85 | 6 98 | 2 86 | 6 67 | 7
數據全都存放在名為 data 的數組中。這通常是通過(guò)循環(huán)從數據庫取得的結果,例如 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() 需要一個(gè)包含列的數組,因此用以下代碼來(lái)取得列,然后排序。
<?php
// 取得列的列表
foreach ($data as $key => $row) {
$volume[$key] = $row['volume'];
$edition[$key] = $row['edition'];
}
// 你可以使用 array_column() 代替上面的代碼
$volume = array_column($data, 'volume');
$edition = array_column($data, 'edition');
// 將數據根據 volume 降序排列,根據 edition 升序排列
// 把 $data 作為最后一個(gè)參數,以通用鍵排序
array_multisort($volume, SORT_DESC, $edition, SORT_ASC, $data);
?>
數據集合現在排好序了,結果如下:
volume | edition -------+-------- 98 | 2 86 | 1 86 | 6 85 | 6 67 | 2 67 | 7
示例 #4 不區分大小寫(xiě)字母排序
SORT_STRING
和
SORT_REGULAR
都是區分大小寫(xiě)字母的,大寫(xiě)字母會(huì )排在小寫(xiě)字母之前。
要進(jìn)行不區分大小寫(xiě)的排序,就要按照原數組的小寫(xiě)字母拷貝來(lái)排序。
<?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);
?>
以上例程會(huì )輸出:
Array ( [0] => Alpha [1] => atomic [2] => bank [3] => Beta )