array_diff_ukey
(PHP 5 >= 5.1.0, PHP 7, PHP 8)
array_diff_ukey — Computa a diferença entre arrays usando uma função callback na comparação de chaves
Descrição
$array1
, array $array2
, array $... = ?
, callable $key_compare_func
) : array
Compara as chaves de array1 com as chaves
de array2 e retorna a diferença.
Esta função é similar a array_diff(), com exceção que a
comparação é feita nas chaves ao invés dos valores.
Diferente de array_diff_key() uma função callback é fornecida e usada para comparação de índices, não função interna.
Parâmetros
-
array1 -
Array a ser comparado
-
array2 -
Array para comparação
-
... -
Mais arrays para comparação
-
key_compare_func -
A 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.
Valor Retornado
Retorna um array contendo todas as entradas de
array1 que não estão presentes em nenhum outro array.
Exemplos
Exemplo #1 Exemplo da função array_diff_ukey()
<?php
function key_compare_func($key1, $key2)
{
if ($key1 == $key2)
return 0;
else if ($key1 > $key2)
return 1;
else
return -1;
}
$array1 = array('blue' => 1, 'red' => 2, 'green' => 3, 'purple' => 4);
$array2 = array('green' => 5, 'blue' => 6, 'yellow' => 7, 'cyan' => 8);
var_dump(array_diff_ukey($array1, $array2, 'key_compare_func'));
?>
O exemplo acima irá imprimir:
array(2) {
["red"]=>
int(2)
["purple"]=>
int(4)
}
Notas
Nota:
Esta função somente verifica uma dimensão de um array com n-dimensões. Obviamente você pode verificar as dimensões usando
array_diff_ukey($array1[0], $array2[0], 'callback_func');.
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 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_key() - Computa a diferença entre arrays usando as chaves na comparação
- 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
add a note
