array_diff_key
(PHP 5 >= 5.1.0, PHP 7, PHP 8)
array_diff_key — 使用鍵名比較計算陣列的差集
說明
array_diff_key(array
$array, array ...$arrays): array
根據 array 中的鍵名和 arrays 進行比較，返回不同鍵名的項。
本函式和
array_diff() 相同只除了比較是根據鍵名而不是值來進行的。
參數
-
array -
從這個陣列進行比較
-
arrays -
要進行比較的陣列
返回值
返回一個陣列，該陣列包含了所有出現在 array 中但是未出現在任何其它陣列中的鍵名的值。
範例
示例 #1 array_diff_key() 例
在 key => value 對中的兩個鍵名僅在
(string) $key1 === (string) $key2
時被認為相等。換句話說，執行的是嚴格型別檢查，因此字串的表達必須完全一樣。
<?php
$array1 = array('blue' => 1, 'red' => 2, 'green' => 3, 'purple' => 4);
$array2 = array('green' => 5, 'yellow' => 7, 'cyan' => 8);
var_dump(array_diff_key($array1, $array2));
?>
以上例程會輸出：
array(3) {
["blue"]=>
int(1)
["red"]=>
int(2)
["purple"]=>
int(4)
}
<?php
$array1 = array('blue' => 1, 'red' => 2, 'green' => 3, 'purple' => 4);
$array2 = array('green' => 5, 'yellow' => 7, 'cyan' => 8);
$array3 = array('blue' => 6, 'yellow' => 7, 'mauve' => 8);
var_dump(array_diff_key($array1, $array2, $array3));
?>
以上例程會輸出：
array(2) {
["red"]=>
int(2)
["purple"]=>
int(4)
}
註釋
注意:
注意本函式只檢查了多維陣列中的一維。當然，可以用
array_diff_key($array1[0], $array2[0]);來檢查更深的維度。
參見
- array_diff() - 計算陣列的差集
- array_udiff() - 用回撥函式比較數據來計算陣列的差集
- array_diff_assoc() - 帶索引檢查計算陣列的差集
- array_diff_uassoc() - 用使用者提供的回撥函式做索引檢查來計算陣列的差集
- array_udiff_assoc() - 帶索引檢查計算陣列的差集，用回撥函式比較數據
- array_udiff_uassoc() - 帶索引檢查計算陣列的差集，用回撥函式比較數據和索引
- array_diff_ukey() - 用回撥函式對鍵名比較計算陣列的差集
- array_intersect() - 計算陣列的交集
- array_intersect_assoc() - 帶索引檢查計算陣列的交集
- array_intersect_uassoc() - 帶索引檢查計算陣列的交集，用回撥函式比較索引
- array_intersect_key() - 使用鍵名比較計算陣列的交集
- array_intersect_ukey() - 在鍵名上使用回撥函式來比較計算陣列的交集