(PHP 5, PHP 7, PHP 8)
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,...$arrays,$value_compare_func,$key_compare_funcComputa a diferença entre arrays com checagem adicional de índice, compara dados e índices por uma função de callback.
Note que as chaves são usadas na comparação, ao contrário de array_diff() e array_udiff().
arrayO primeiro array.
arraysArrays para comparar.
value_compare_funcA função de comparação deve retornar um inteiro menor que, igual ou maior que zero se o primeiro argumento for considerado respectivamente menor que, igual ou maior que o segundo.
Retornar valores não inteiros da função de
comparação, como float, resultará em uma conversão interna
do valor retornado da função callback para int. Portanto, valores como
0.99 e 0.1 serão convertidos para o
valor inteiro 0, o que comparará esses valores como iguais.
A função chamada de ordenação deve lidar com qualquer valor de qualquer array em qualquer ordem, independentemente da ordem em que eles foram originalmente fornecidos. O motivo é que cada array individual é primeiramente ordenado antes de ser comparado com outros arrays. Por exemplo:
<?php
$arrayA = ["string", 1];
$arrayB = [["value" => 1]];
// $item1 e $item2 podem ser "string", 1 ou ["value" => 1]
$compareFunc = static function ($item1, $item2) {
$value1 = is_string($item1) ? strlen($item1) : (is_array($item1) ? $item1["value"] : $item1);
$value2 = is_string($item2) ? strlen($item2) : (is_array($item2) ? $item2["value"] : $item2);
return $value1 <=> $value2;
};
?>key_compare_func
A comparação das chaves (índices) é feita também por função de
callback: key_compare_func. Este comportamento é
contrário ao que array_udiff_assoc() faz, já que
esta compara os índices usando uma função interna.
Retorna um array contendo todos os valores de
array que não estão presentes em qualquer dos
outros argumentos.
Exemplo #1 Exemplo de array_udiff_uassoc()
<?php
class cr {
private $priv_member;
function __construct($val)
{
$this->priv_member = $val;
}
static function comp_func_cr($a, $b)
{
if ($a->priv_member === $b->priv_member) return 0;
return ($a->priv_member > $b->priv_member)? 1:-1;
}
static function comp_func_key($a, $b)
{
if ($a === $b) return 0;
return ($a > $b)? 1:-1;
}
}
$a = array("0.1" => new cr(9), "0.5" => new cr(12), 0 => new cr(23), 1=> new cr(4), 2 => new cr(-15),);
$b = array("0.2" => new cr(9), "0.5" => new cr(22), 0 => new cr(3), 1=> new cr(4), 2 => new cr(-15),);
$result = array_udiff_uassoc($a, $b, array("cr", "comp_func_cr"), array("cr", "comp_func_key"));
print_r($result);
?>O exemplo acima produzirá:
Array
(
[0.1] => cr Object
(
[priv_member:private] => 9
)
[0.5] => cr Object
(
[priv_member:private] => 12
)
[0] => cr Object
(
[priv_member:private] => 23
)
)
Em nosso exemplo acima é possível ver que o par "1" => new cr(4)
está presente em ambos os arrays e assim não está na saída da função.
Mantenha em mente que duas funções de retorno devem ser fornecidas.
Nota: Observe que esta função somente verifica uma dimensão de um array n-dimensional. É claro que dimensões mais profundas podem ser verificadas usando, por exemplo,
array_udiff_uassoc($array1[0], $array2[0], "func_compara_dados", "func_compara_chave");.