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() 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. |
Exemplos
Example #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