array_udiff_assoc()

(PHP 5, PHP 7)

带索引检查计算数组的差集，用回调函数比较数据

说明

array_udiff_assoc(array $array1,array $array2[,array $...],callable$value_compare_func): array

此比较是通过用户提供的回调函数来进行的。如果认为第一个参数小于，等于，或大于第二个参数时必须分别返回一个小于零，等于零，或大于零的整数。

Note:注意本函数只检查了多维数组中的一维。当然，可以用array_udiff_assoc($array1[0],$array2[0],"some_comparison_func");来检查更深的维度。

参数

$array1: 第一个数组。
$array2: 第二个数组。
$value_compare_func: 在第一个参数小于，等于或大于第二个参数时，该比较函数必须相应地返回一个小于，等于或大于 0 的整数。
callback(mixed $a,mixed $b): int

返回值

array_udiff_assoc()返回一个数组，该数组包括了所有在$array1中但是不在任何其它参数数组中的值。注意和array_diff()与array_udiff()不同的是键名也用于比较。数组数据的比较是用用户提供的回调函数进行的。在此方面和array_diff_assoc()的行为正好相反，后者是用内部函数进行比较的。

范例

Example #1array_udiff_assoc()例子

<?php
class cr {
    private $priv_member;
    function cr($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;
    }
}
$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_assoc($a, $b, array("cr", "comp_func_cr"));
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
        )
)

上例中可以看到键值对"1"=> new cr(4)同时出现在两个数组中因此不在本函数的输出中。

参见

array_diff() 计算数组的差集
array_diff_assoc() 带索引检查计算数组的差集
array_diff_uassoc() 用用户提供的回调函数做索引检查来计算数组的差集
array_udiff() 用回调函数比较数据来计算数组的差集
array_udiff_uassoc() 带索引检查计算数组的差集，用回调函数比较数据和索引
array_intersect() 计算数组的交集
array_intersect_assoc() 带索引检查计算数组的交集
array_uintersect() 计算数组的交集，用回调函数比较数据
array_uintersect_assoc() 带索引检查计算数组的交集，用回调函数比较数据
array_uintersect_uassoc() 带索引检查计算数组的交集，用单独的回调函数比较数据和索引

Difference between array_udiff_assoc() and array_diff_assoc()
- array_udiff_assoc(): Compares the DATA with the user supplied callback function
- array_diff_assoc(): Compares the INDEX with the user supplied callback function

The example #1 can be modified (PHP 7 or higher) by using Spaceship operator (<=>):
<?php
//…
static function comp_func_cr($a, $b)
{
  return $a->priv_member <=> $b->priv_member;
}
//…
?>