array_diff_key

(PHP 5 >= 5.1.0)

array_diff_key — Registra a diferença entre arrays usando chaves para comparação

Descrição

array array_diff_key ( array $array1 , array $array2 [, array $... ] )

Compara as chaves do array1 com as chaves do array2 e retorna a diferença. Esta função é como array_diff(), exceto que a comparação é feita com as chaves, ao invés dos valores.

Parâmetros

array1: O array a comparar
array2: Um array a ser comparado
...: Mais arrays a serem comparados

Valor Retornado

Retorna um array contendo todas as entradas de array1 cujas chaves não estão presentes em qualquer dos outros arrays.

Exemplos

Example #1 Exemplo de array_diff_key()

As duas chaves dos pares chave => valor são consideradas iguais somente se (string) $key1 === (string) $key2 . Em outras palavras, uma checagem de tipo estrita é feita para que representações de string sejam as mesmas.


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

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

O exemplo acima irá imprimir:

array(2) {
  ["vermelho"]=>
  int(2)
  ["roxo"]=>
  int(4)
}

Notas

Note:
Essa função checa somente uma dimensão de um array n-dimensional. É claro que você pode checar dimensões mais profundas usando array_diff_key($array1[0], $array2[0]);.

Veja Também

array_diff() - Analisa 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_ukey() - Computa a diferença de 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_key() - Computa a interseção de array comparando pelas chaves
array_intersect_ukey() - Computa a interseção de arrays usando uma função de callback nas chaves para comparação