用array_diff_ukey() 找出兩個數組鍵名的差異

M66 2025-05-15

在PHP 中， array_diff_ukey()是一個非常有用的函數，它可以用來比較兩個數組的鍵名，並返回第一個數組中那些不在第二個數組中的鍵名。這個函數非常適用於我們需要找出兩個數組在鍵名上的差異時，尤其是當鍵名比較複雜時，可以通過自定義的比較函數來進行判斷。

函數簡介

array_diff_ukey()函數的原型如下：

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

$array1 ：要進行比較的第一個數組。
$array2 ：要與第一個數組比較的第二個數組。
$key_compare_func ：一個自定義的比較函數，用於比較兩個鍵名。這個函數接收兩個鍵名作為參數，應該返回一個整數，表示比較的結果。

示例代碼

讓我們看一個具體的例子，來演示如何使用array_diff_ukey()函數找出兩個數組之間鍵名的差異。

 <?php
// 定義兩個數組
$array1 = [
    'apple' => 1,
    'banana' => 2,
    'cherry' => 3,
];

$array2 = [
    'banana' => 4,
    'date' => 5,
    'fig' => 6,
];

// 自定義比較函數
function key_compare_func($key1, $key2) {
    // 直接比較鍵名是否相等
    return strcmp($key1, $key2);
}

// 使用 array_diff_ukey() 比較兩個數組的鍵名
$result = array_diff_ukey($array1, $array2, 'key_compare_func');

// 輸出結果
print_r($result);
?>

結果輸出：

 Array
(
    [apple] => 1
    [cherry] => 3
)

解析

在上面的示例中，我們有兩個數組$array1和$array2 ，其中$array1包含鍵名為'apple' 、 'banana'和'cherry' ，而$array2包含鍵名為'banana' 、 'date'和'fig' 。通過調用array_diff_ukey() ，我們傳入了一個自定義的比較函數key_compare_func ，該函數用於比較兩個鍵名是否相同。最終，函數返回了一個新的數組，其中包含$array1中的鍵名'apple'和'cherry' ，因為這兩個鍵名在$array2中沒有出現。

使用自定義的比較函數

array_diff_ukey()的強大之處在於它支持自定義比較函數。這意味著我們不僅可以進行簡單的鍵名比較，還可以根據自己的需求編寫複雜的比較邏輯。例如，如果我們需要忽略鍵名中的大小寫差異，可以在比較函數中實現這一點。

示例：忽略大小寫比較

<?php
// 定義兩個數組
$array1 = [
    'Apple' => 1,
    'banana' => 2,
    'cherry' => 3,
];

$array2 = [
    'apple' => 4,
    'Date' => 5,
    'fig' => 6,
];

// 自定義比較函數，忽略大小寫
function case_insensitive_key_compare_func($key1, $key2) {
    return strcasecmp($key1, $key2);
}

// 使用 array_diff_ukey() 比較兩個數組的鍵名
$result = array_diff_ukey($array1, $array2, 'case_insensitive_key_compare_func');

// 輸出結果
print_r($result);
?>

結果輸出：

 Array
(
    [banana] => 2
    [cherry] => 3
)

在這個例子中，儘管$array1中的'Apple'和$array2中的'apple'鍵名大小寫不同，但由於我們使用了strcasecmp函數進行比較，PHP 會忽略大小寫的差異，認為它們是相同的鍵名。因此，最終的結果只會返回'banana'和'cherry'這兩個鍵名，因為'apple'被認為已經在$array2中找到了。

總結

通過使用array_diff_ukey()函數，我們能夠方便地找出兩個數組之間在鍵名上的差異。這個函數非常強大，支持自定義比較邏輯，因此可以應對各種複雜的比較需求。無論是簡單的鍵名比較，還是需要忽略大小寫的比較， array_diff_ukey()都能輕鬆處理。