(PHP 4, PHP 5, PHP 7)
array_multisort — 對多個數組或多維陣列進行排序

說明

bool array_multisort ( array &$array1 [, mixed $array1_sort_order = SORT_ASC [, mixed $array1_sort_flags = SORT_REGULAR [, mixed $... ]]] )

array_multisort() 可以用來一次對多個數組進行排序，或者根據某一維或多維對多維陣列進行排序。

關聯（string）鍵名保持不變，但數字鍵名會被重新索引。

Note:
如果兩個成員相等，則它們在排序陣列中的相對順序是未定義的。
 

引數

array1
要排序的 array。

array1_sort_order
之前 array 引數要排列的順序。 SORT_ASC 按照上升順序排序， SORT_DESC 按照下降順序排序。

此引數可以和 array1_sort_flags 互換，也可以完全刪除，預設是 SORT_ASC 。

array1_sort_flags
為 array 引數設定選項：

排序型別標誌：

SORT_REGULAR - 將專案按照通常方法比較（不修改型別）
SORT_NUMERIC - 按照數字大小比較
SORT_STRING - 按照字串比較
SORT_LOCALE_STRING - 根據當前的本地化設定，按照字串比較。 它會使用 locale 資訊，可以通過 setlocale() 修改此資訊。
SORT_NATURAL - 以字串的"自然排序"，類似 natsort()
SORT_FLAG_CASE - 可以組合 (按位或 OR) SORT_STRING 或者 SORT_NATURAL 大小寫不敏感的方式排序字串。
引數可以和 array1_sort_order 交換或者省略，預設情況下是 SORT_REGULAR。

...

可選的選項，可提供更多陣列，跟隨在 sort order 和 sort flag 之後。 提供的陣列和之前的陣列要有相同數量的元素。 換言之，排序是按字典順序排列的。

返回值

成功時返回 TRUE， 或者在失敗時返回 FALSE。

更新日誌

範例

Example #1 多個數組排序

<?php
$ar1 = array(10, 100, 100, 0);
$ar2 = array(1, 3, 2, 4);
array_multisort($ar1, $ar2);

var_dump($ar1);
var_dump($ar2);
?>
 

這個例子裡，排序後，第一個陣列會包含 0、 10、 100、 100。 第二個陣列會包含 4、1、 2、 3。 第二個數組裡的專案對應第一個陣列後也進行了排序（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)
}

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
)