array_intersect_key

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

    array_intersect_key — Calcula a interseção de arrays, comparando pelas chaves

    Descrição

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

    array_intersect_key() retorna um array contendo todos os valores de array que tem as mesmas chaves presentes em todos os argumentos.

    Parâmetros

    array

    O array com as chaves a serem verificadas.

    arrays

    Arrays para comparar as chaves.

    Valor Retornado

    Retorna um array associativo contendo todos os valores de array que estão presentes em todos os argumentos.

    Registro de Alterações

    VersãoDescrição
    8.0.0 Esta função agora pode ser chamada com apenas um parâmetro. Anteriormente, pelo menos dois parâmetros eram necessários.

    Exemplos

    Exemplo #1 Exemplo da array_intersect_key()

    <?php
    $array1     = array('azul' => 1, 'vermelho' => 2, 'verde' => 3, 'roxo' => 4);
    $array2 = array('verde' => 5, 'azul' => 6, 'amarelo' => 7, 'ciano' => 8);

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

    O exemplo acima produzirá:

    array(2) { ["azul"]=> int(1) ["verde"]=> int(3) }

    Em nosso exemplo você pode ver que somente as chaves 'azul' e 'verde' estão presentes em ambos os array e assim são retornados. Também note que os valores das chaves 'azul' e 'verde' diferem nos dois arrays. A combinação ocorre porque somente as chaves são verificadas. Os valores retornados são do array.

    As duas chaves do par key => value são considerados iguais somente se (string) $key1 === (string) $key2 . Em outras palavras um verificação do tipo é executada, então a representação string precisa ser a mesma.

    Veja Também

    • array_diff() - Computa as diferenças entre arrays
    • array_udiff() - Computa a diferença de arrays usando uma função de callback para comparação dos dados
    • array_diff_assoc() - Computa a diferença entre arrays com checagem adicional de índice
    • array_diff_uassoc() - Computa a diferença entre arrays com checagem adicional de índice que feita por uma função de callback fornecida pelo usuário
    • array_udiff_assoc() - Computa a diferença entre arrays com checagem adicional de índice, compara dados por uma função de callback
    • array_udiff_uassoc() - Computa a diferença entre arrays com checagem adicional de índice, compara dados e índices por uma função de callback
    • array_diff_key() - Computa a diferença entre arrays usando as chaves na comparação
    • array_diff_ukey() - Computa a diferença entre arrays usando uma função callback na comparação de chaves
    • array_intersect() - Calcula a interseção entre arrays
    • array_intersect_assoc() - Computa a interseção de arrays com uma adicional verificação de índice
    • array_intersect_uassoc() - Computa a interseção de arrays com checagem de índice adicional, compara índices por uma função de callback
    • array_intersect_ukey() - Computa a interseção de arrays usando uma função de callback nas chaves para comparação
    To Top