(PHP 5 >= 5.1.0, PHP 7, PHP 8)
array_diff_key — Вычисляет расхождение массивов, сравнивая ключи
Сравнивает ключи array
с ключами
arrays
и возвращает разницу.
Эта функция схожа с array_diff() за исключением
того, что сравниваются ключи, а не значения.
array
Исходный массив
arrays
Массивы для сравнения
Возвращает массив (array), содержащий все элементы
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) }
Замечание:
Эта функция обрабатывает только одно измерение n-размерного массива. Естественно, вы можете обрабатывать и более глубокие уровни вложенности, например, используя
array_diff_key($array1[0], $array2[0]);
.