array_intersect_key

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

    array_intersect_key — Вычисляет пересечение массивов, сравнивая ключи

    Описание

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

    Функция array_intersect_key() возвращает массив, содержащий все элементы массива array, имеющие ключи, содержащиеся во всех других параметрах.

    Список параметров

    array

    Основной проверяемый массив.

    arrays

    Массив, с которым идёт сравнение.

    Возвращаемые значения

    Возвращает ассоциативный массив, содержащий все элементы массива array, имеющие ключи, содержащиеся во всех остальных параметрах.

    Список изменений

    ВерсияОписание
    8.0.0 Теперь разрешается вызывать функцию только с одним параметром. Раньше требовалось не менее двух параметров.

    Примеры

    Пример #1 Пример использования функции array_intersect_key()

    <?php
    $array1     = array('blue' => 1, 'red' => 2, 'green' => 3, 'purple' => 4);
    $array2 = array('green' => 5, 'blue' => 6, 'yellow' => 7, 'cyan' => 8);

    var_dump(array_intersect_key($array1, $array2));
    ?>

    Результат выполнения приведённого примера: 

    array(2) { ["blue"]=> int(1) ["green"]=> int(3) }

    В данном примере только ключи 'blue' и 'green' содержатся в обоих массивах, и поэтому возвращаются. Обратите внимание, что значения клюей 'blue' и 'green' неодинаковые в двух массивах. Совпадение всё равно есть, так как сравниваются только ключи. Возвращаемые значения берутся из массива array.

    Два ключа пар key => value признаются равными, только если выражение (string) $key1 === (string) $key2 истинно. Проще говоря, выполняется строгая проверка строковых представлений, которые должны быть одинаковыми.

    Смотрите также

    • array_diff() - Вычисляет расхождение массивов
    • array_udiff() - Вычисляет расхождение массивов, используя для сравнения callback-функцию
    • array_diff_assoc() - Вычисляет расхождение массивов с дополнительной проверкой индекса
    • array_diff_uassoc() - Вычисляет расхождение массивов с дополнительной проверкой индекса через пользовательскую callback-функцию
    • array_udiff_assoc() - Вычисляет расхождение в массивах с дополнительной проверкой индексов, используя для сравнения значений callback-функцию
    • array_udiff_uassoc() - Вычисляет расхождение в массивах с дополнительной проверкой индексов, используя для сравнения значений и индексов callback-функцию
    • array_diff_key() - Вычисляет расхождение массивов, сравнивая ключи
    • array_diff_ukey() - Вычисляет расхождение массивов, используя callback-функцию для сравнения ключей
    • array_intersect() - Вычисляет пересечение массивов
    • array_intersect_assoc() - Вычисляет пересечение массивов с дополнительной проверкой индекса
    • array_intersect_uassoc() - Вычисляет пересечение массивов с дополнительной проверкой индекса, сравнивая индексы через callback-функцию
    • array_intersect_ukey() - Вычисляет пересечение массивов, используя callback-функцию для сравнения ключей
    To Top