(PHP 5, PHP 7, PHP 8)
array_udiff_uassoc — Calcula la diferencia entre dos arrays asociativos, compara los datos y los índices con una función de retorno
$array
,...$arrays
,$value_compare_func
,$key_compare_func
Calcula la diferencia entre dos arrays asociativos, compara los datos y los índices con una función de retorno.
Se debe tener en cuenta que las claves se utilizan en las comparaciones, a diferencia de array_diff() y array_udiff().
array
El primer array.
arrays
Arrays a comparar
value_compare_func
La función de comparación debe devolver un entero menor, igual o mayor que cero si el primer argumento se considera que sea respectivamente menor, igual o mayor que el segundo. Observe que antes de PHP 7.0.0 este entero debía estar en el rango de -2147483648 a 2147483647.
Returning non-integer values from the comparison
function, such as float, will result in an internal cast to
int of the callback's return value. So values such as
0.99
and 0.1
will both be cast to an
integer value of 0
, which will compare such values as equal.
The sorting callback must handle any value from any array in any order, regardless of the order they were originally provided. This is because each individual array is first sorted before being compared against other arrays. For example:
<?php
$arrayA = ["string", 1];
$arrayB = [["value" => 1]];
// $item1 and $item2 can be any of "string", 1 or ["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
La comparación de las claves (índices) se realiza mediante la función de retorno
key_compare_func
. Este comportamiento difiere del de
array_udiff_assoc(), ya que esta última utiliza una función interna
para comparar los índices.
Devuelve un array que contiene todas las claves del array
array
que no están presentes en
ningún otro argumento.
Ejemplo #1 Ejemplo con 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);
?>
El resultado del ejemplo sería:
Array ( [0.1] => cr Object ( [priv_member:cr:private] => 9 ) [0.5] => cr Object ( [priv_member:cr:private] => 12 ) [0] => cr Object ( [priv_member:cr:private] => 23 ) )
En nuestro ejemplo, se observa que el par "1" => new cr(4)
está presente en ambos arrays y, por lo tanto, ausente del array resultante.
Se debe tener en cuenta que se deben proporcionar dos funciones de retorno.
Nota: Se debe tener en cuenta que esta función solo verifica una dimensión de un array multidimensional. Por supuesto, se puede probar una dimensión particular utilizando, por ejemplo,
array_udiff_uassoc($array1[0], $array2[0], "data_compare_func", "key_compare_func");
.