(PHP 5, PHP 7, PHP 8)
array_udiff_uassoc — Calcula la diferencia de dos arrays asociativos, compara los datos y los índices con una función de retrollamada
$array
,...$arrays
,$value_compare_func
,$key_compare_func
Calcula la diferencia de dos arrays asociativos, compara los datos y los índices con una función de retrollamada.
Téngase 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 contra
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 retrollamada
key_compare_func
. Este comportamiento es diferente al de
array_udiff_assoc(), ya que esta última utiliza una función interna
para comparar los índices.
Devuelve un array que contiene todos los valores 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:private] => 9 ) [0.5] => cr Object ( [priv_member:private] => 12 ) [0] => cr Object ( [priv_member:private] => 23 ) )
En nuestro ejemplo, se puede observar que la pareja "1" => new cr(4)
está presente en ambos arrays y, por lo tanto, está ausente en el array resultante.
Téngase en cuenta que se deben proporcionar dos funciones de retrollamada.
Nota: Téngase 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");
.