(PHP 5, PHP 7)
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
$array1
, array $array2
[, array $...
], callback $key_compare_func
)
Compara array1 com array2 e
retorna a diferença. Ao contrário de array_diff(), as
chaves dos arrays são usadas na comparação.
Ao contrário de array_diff_assoc(), uma função de callback fornecida pelo usuário é usada na comparação dos índices, não uma função interna.
array1O array a comparar
array2Um array a ser comparado
...Mais arrays a serem comparados
key_compare_funcA função de comparação precisa retornar um inteiro menor, igual, ou maior que zero caso o primeiro argumento seja considerado respectivamente maior, igual ou maior que o segundo. Note que antes do PHP 7.0.0 este inteiro tinha de estar no intervalo de -2147483648 a 2147483647.
Retorna um array contendo todas as entradas de
array1 que não estão presentes em qualquer um dos outros arrays.
Exemplo #1 Exemplo de array_diff_uassoc()
O par "a" => "verde" está presente em ambos os arrays e assim não está na saída da função. Ao contrário disso, o par 0 => "vermelho" está na saída porque no segundo argumento "vermelho" tem a chave 1.
<?php
function key_compare_func($a, $b)
{
if ($a === $b) {
return 0;
}
return ($a > $b)? 1:-1;
}
$array1 = array("a" => "verde", "b" => "marrom", "c" => "azul", "vermelho");
$array2 = array("a" => "verde", "amarelo", "vermelho");
$result = array_diff_uassoc($array1, $array2, "key_compare_func");
print_r($result);
?>
O exemplo acima irá imprimir:
Array
(
[b] => marrom
[c] => azul
[0] => vermelho
)
A igualdade de 2 índices é checada pela função de callback fornecida pelo usuário.
Nota:
Esta função checa somente uma dimensão de um array n-dimensional. É claro que você pode checar dimensões mais profundas usando, por exemplo, array_diff_uassoc($array1[0], $array2[0], "key_compare_func");.