说明

array_diff_key(array $array, array ...$arrays): array

根据 array 中的键名和 arrays 进行比较，返回不同键名的项。本函数和 array_diff() 相同只除了比较是根据键名而不是值来进行的。

参数

array: 从这个数组进行比较
arrays: 要进行比较的数组

返回值

返回一个数组，该数组包含了所有出现在 array 中但是未出现在任何其它数组中的键名的值。

更新日志

版本说明

8.0.0 现在可以仅使用一个参数调用此函数。以前，至少需要两个参数。

版本	说明
8.0.0	现在可以仅使用一个参数调用此函数。以前，至少需要两个参数。

示例

示例 #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() - 在键名上使用回调函数来比较计算数组的交集