使用键名比较计算数组的差集

# array_diff_key

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

array_diff_key — 使用键名比较计算数组的差集

### 说明

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

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

### 参数

`array`

  从这个数组进行比较

`arrays`

  要进行比较的数组

### 返回值

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

### 更新日志

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open