(PHP 5, PHP 7, PHP 8)
array_udiff_uassoc — Computes the difference of arrays with additional index check, compares data and indexes by a callback function
$array
,...$arrays
,$value_compare_func
,$key_compare_func
Computes the difference of arrays with additional index check, compares data and indexes by a callback function.
Note that the keys are used in the comparison unlike array_diff() and array_udiff().
array
The first array.
arrays
Arrays to compare against.
value_compare_func
Порівняльна функція має повертати ціле число, котре менше, рівне або більше нуля, якщо перший параметр вважається відповідно меншим, рівним або більшим за другий.
Якщо функція порівняння повертає не цілі значення, такі
як float, вони будуть приведені до типу int під час
повернення з функції зворотнього виклику. Тож значення, схожі на
0.99
або 0.1
будуть приведені до цілого
0
, отже члени порівняння вважатимуться однаковими.
Сортувальна функція зворотнього виклику повинна опрацьовувати будь-яке значення з будь-якого масиву у будь-якій послідовності, не залежно від їхнього початкового порядку. Це тому, що кожен масив впорядковується перед порівнянням його з іншими масивами. Наприклад:
<?php
$arrayA = ["string", 1];
$arrayB = [["value" => 1]];
// $item1 та $item2 можуть бути "string", 1 чи ["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
The comparison of keys (indices) is done also by the callback function
key_compare_func
. This behaviour is unlike what
array_udiff_assoc() does, since the latter compares
the indices by using an internal function.
Returns an array containing all the values from
array
that are not present in any of the other
arguments.
Приклад #1 array_udiff_uassoc() example
<?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);
?>
Поданий вище приклад виведе:
Array ( [0.1] => cr Object ( [priv_member:private] => 9 ) [0.5] => cr Object ( [priv_member:private] => 12 ) [0] => cr Object ( [priv_member:private] => 23 ) )
In our example above you see the "1" => new cr(4)
pair is present in both arrays and thus it is not in the output from the
function. Keep in mind that you have to supply 2 callback functions.
Зауваження: Please note that this function only checks one dimension of a n-dimensional array. Of course you can check deeper dimensions by using, for example,
array_udiff_uassoc($array1[0], $array2[0], "data_compare_func", "key_compare_func");
.