array_diff
(PHP 4 >= 4.0.1, PHP 5)
array_diff — Analisa as diferenças entre arrays
Descrição
$array1
, array $array2
[, array $ ...
] )
Compara array1 com array2 e
retorna a diferença.
Parâmetros
-
array1 -
O array a ser comparado
-
array2 -
Um array para comparar
-
... -
Mais arrays para comparar
Valor Retornado
Retorna um array contendo todas as entradas de
array1 que não estão presentes em algum dos outros arrays.
Exemplos
Example #1 Exemplo da array_diff()
<?php
$array1 = array("a" => "verde", "vermelho", "azul", "vermelho");
$array2 = array("b" => "verde", "amarelo", "vermelho");
$result = array_diff($array1, $array2);
print_r($result);
?>
Multiplas ocorrências de $array1 são todas tratadas da mesma maneira. Isto irá mostrar:
Array ( [1] => azul )
Notas
Note:
Dois elementos são considerados iguais se, e somente se, (string) $elem1 === (string) $elem2. Em palavras: quando a representação em string é a mesma.
Note:
Esta função faz compara apenas uma dimensão de um array com n dimensões. Mas, obviamente, você pode comparar outras dimensões usando array_diff($array1[0], $array2[0]);.
Não estava funcionando no PHP 4.0.4!
Veja Também
- array_diff_assoc() - Computa a diferença entre arrays com checagem adicional de índice
- array_intersect() - Calcula a interseção entre arrays
- array_intersect_assoc() - Computa a interseção de arrays com uma adicional verificação de índice