rsort() 是 PHP 內建的陣列反向排序函式,能將陣列元素由大到小排序。與 arsort() 不同,rsort() 會重新建立數字索引,不保留原有鍵名。本文詳細解析其語法、參數、行為特性與實戰陷阱。
bool rsort ( array &$array [, int $sort_flags = SORT_REGULAR ] )
$array:參考傳遞,直接修改原陣列$sort_flags:排序模式旗標(可選)true 成功、false 失敗| 旗標常數 | 行為描述 | 適用場景 |
|---|---|---|
SORT_REGULAR | 預設。依原型別比較(不轉型) | 一般字串/數值混合陣列 |
SORT_NUMERIC | 將值視為數值比較 | 純數字陣列、數值字串 |
SORT_STRING | 將值視為字串比較 | 字串排序、避免數值轉換 |
SORT_LOCALE_STRING | 依當前區域設定比較字串 | 多語言環境、特定語系排序 |
rsort() 會刪除所有原有鍵名,重新建立 0 起始的數字索引。 這與 arsort()(保留鍵名關聯)是最大不同。
<?php
$animals = [
"dog" => "large",
"cat" => "medium",
"mouse" => "small"
];
print_r($animals);
/*
Array
(
[dog] => large
[cat] => medium
[mouse] => small
)
*/
rsort($animals);
print_r($animals);
/*
Array
(
[0] => small
[1] => medium
[2] => large
)
// 原有鍵名 dog/cat/mouse 已消失!
*/
?>
<?php
$fruits = ["橘子", "蘋果", "香蕉", "西瓜"];
rsort($fruits, SORT_STRING);
print_r($fruits);
/*
Array
(
[0] => 西瓜
[1] => 香蕉
[2] => 蘋果
[3] => 橘子
)
*/
?>
<?php
$mixed = ["10", "2", "1", "20", "3"];
rsort($mixed, SORT_REGULAR); // 字串比較:"3" > "20" > "2" > "10" > "1"
print_r($mixed);
// [0] => 3, [1] => 20, [2] => 2, [3] => 10, [4] => 1
$mixed = ["10", "2", "1", "20", "3"];
rsort($mixed, SORT_NUMERIC); // 數值比較:20 > 10 > 3 > 2 > 1
print_r($mixed);
// [0] => 20, [1] => 10, [2] => 3, [3] => 2, [4] => 1
?>
解決:使用 arsort()(值反向排序、保留鍵名)或 krsort()(鍵名反向排序)
<?php
$users = [
['name' => 'Alice', 'age' => 25],
['name' => 'Bob', 'age' => 30],
['name' => 'Charlie', 'age' => 20]
];
// rsort($users); // ❌ 無法直接排序多維陣列
// 正確做法:usort + 自訂比較函式
usort($users, function($a, $b) {
return $b['age'] - $a['age']; // 年齡降序
});
?>
<?php
// 必須先設定 locale
setlocale(LC_ALL, 'zh_TW.utf8'); // 或 en_US.utf8
$chinese = ["張三", "李四", "王五", "趙六"];
rsort($chinese, SORT_LOCALE_STRING); // 依中文筆畫/拼音排序
?>
| 函式 | 排序依據 | 順序 | 保留鍵名 |
|---|---|---|---|
sort() | 值 | 升序 | ❌ 重置索引 |
rsort() | 值 | 降序 | ❌ 重置索引 |
asort() | 值 | 升序 | ✅ 保留關聯 |
arsort() | 值 | 降序 | ✅ 保留關聯 |
ksort() | 鍵名 | 升序 | ✅ 保留關聯 |
krsort() | 鍵名 | 降序 | ✅ 保留關聯 |
usort() | 自訂 | 自訂 | ❌ 重置索引 |
uasort() | 自訂 | 自訂 | ✅ 保留關聯 |
uksort() | 鍵名自訂 | 自訂 | ✅ 保留關聯 |
rsort() 使用快速排序演算法,平均時間複雜度 O(n log n)SplHeap 或 SplPriorityQueue 維護有序結構rsort() 是處理索引陣列反向排序的最佳選擇,但務必記住它會破壞關聯鍵名。需要保留鍵值關聯時請改用 arsort();需依鍵名排序用 krsort();複雜多維排序則使用 usort() 族群。根據資料結構選擇正確函式,才能避免難以發現的資料遺失Bug。