使用array_diff_uassoc() 時，原始數組的鍵順序是否會被保留？

M66 2025-06-06

在PHP 中， array_diff_uassoc()是一個非常有用的數組函數，它可以計算兩個數組的差集，同時還允許用戶使用自定義的比較函數來比較數組的鍵。很多開發者在使用該函數時常常有一個疑問：

為了回答這個問題，我們首先需要了解array_diff_uassoc()的基本使用方法以及它的行為。

array_diff_uassoc()函數簡介

array_diff_uassoc()函數用於計算兩個數組之間的差集，類似於array_diff() ，但與之不同的是， array_diff_uassoc()會同時比較數組的鍵和值。它的函數原型如下：

 array array_diff_uassoc ( array $array1 , array $array2 , callable $key_compare_func )

$array1 : 這是第一個數組，將與其他數組進行比較。
$array2 : 這是需要比較的數組，通常是一個或多個數組。
$key_compare_func : 這是一個自定義的回調函數，用於比較兩個數組元素的鍵。該函數應該接受兩個鍵作為參數並返回一個比較結果。

保留鍵順序嗎？

回到問題的核心，使用array_diff_uassoc()時，原始數組的鍵順序會被保留嗎？

答案是：是的， array_diff_uassoc()會保留原始數組的鍵順序。當執行數組差集操作時， array_diff_uassoc()會遍歷第一個數組（ $array1 ），並按原始的鍵順序返回那些在第二個數組中不存在的元素。也就是說， $array1中的鍵順序不會被打亂。

示例

我們可以通過以下示例來演示這一點：

 <?php
$array1 = [
    0 => 'a',
    1 => 'b',
    2 => 'c',
    3 => 'd'
];

$array2 = [
    0 => 'a',
    2 => 'c'
];

$result = array_diff_uassoc($array1, $array2, 'strcasecmp');

print_r($result);
?>

輸出：

 Array
(
    [1] => b
    [3] => d
)

如上所示， array_diff_uassoc()函數成功保留了$array1數組中鍵1和3的順序，並且返回了那些在$array2中不存在的元素。這表明，原始數組的鍵順序並沒有改變。

為什麼會保留鍵順序？

這是因為array_diff_uassoc()的實現方式是基於PHP 的array_diff()函數。 array_diff()函數返回的數組是按第一個數組（即$array1 ）的順序排列的，而array_diff_uassoc()在此基礎上添加了鍵的比較功能。因此，它自然會保留原始數組的鍵順序。

注意事項

雖然array_diff_uassoc()保留了原始數組的鍵順序，但我們仍然需要注意以下幾點：

如果第二個數組（ $array2 ）中的元素包含與第一個數組中相同的鍵，那麼這些元素會被從差集結果中移除，不管它們在第二個數組中的位置如何。
如果你需要對結果數組進行排序，PHP 提供了多個函數，如ksort()或asort() ，可以根據需求對結果進行排序。

結論

在使用array_diff_uassoc()時，原始數組的鍵順序是會被保留的。這對於需要確保鍵順序不被打亂的情況非常有用，特別是在處理需要維持某種順序的多維數組或關聯數組時。