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ão Descriçã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.

Versão	Descriçã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, é possível pode ver que somente as chaves 'azul' e 'verde' estão presentes em ambos os array e assim são retornados. Observe Também 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 verificação adicional de índice, comparando dados por uma função de retorno
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 retorno nas chaves para comparação