array_udiff()

1. 定义

该函数使用用户自定义的比较函数对两个数组的键值进行比较，比较第一个数组与其后的数组之间的差集。 返回第一个数组与后面数组的差集数组。

注：

• 差集：A与B的差集为，A集合中与B集合不相同的元素
• 该函数使用用户自定义的函数比较数组元素的键值

2. 语法

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

3. 参数说明

其中，$value_compare_func参数是一个回调函数名的字符串，用户必须定义这个函数。该函数接受两个参数，并且需要在比较两个参数后，相应地返回一个小于零（第一个参数小于第二个参数时）、大于零（第一个参数大于第二个参数时）或者等于零（两个参数相等时）的整数。

4. 示例

<?php

// array_udiff()
// 使用**用户自定义的比较函数**对两个数组的**键值**进行比较，比较第一个数组与其后的数组之间的差集

$arr1 = [1, 2, 3, 'name'=>'极速数据', 'arr'=>['a', 'b']];
$arr2 = [2, 8, 'host'=>'https://www.jisuapi.com/'];
$arr3 = [3, 'arr2'=>['a', 'b']];

function value_compare_func($value_a, $value_b)
{
    if($value_a === $value_b) {
        return 0;
    }
    return ($value_a > $value_b) ? 1 : -1;
}

$diff = array_udiff($arr1, $arr2, 'value_compare_func');
var_dump($diff);
/* 输出：
array(4) {
  [0]=>
  int(1)
  [2]=>
  int(3)
  ["name"]=>
  string(12) "极速数据"
  ["arr"]=>
  array(2) {
    [0]=>
    string(1) "a"
    [1]=>
    string(1) "b"
  }
}
*/

$diff = array_udiff($arr1, $arr3, 'value_compare_func');
var_dump($diff);
/* 输出：
array(3) {
  [0]=>
  int(1)
  [1]=>
  int(2)
  ["name"]=>
  string(12) "极速数据"
}
*/

$diff = array_udiff($arr1, $arr2, $arr3, 'value_compare_func');
var_dump($diff);
/* 输出：
array(2) {
  [0]=>
  int(1)
  ["name"]=>
  string(12) "极速数据"
}
*/

5. 延展阅读

• array_diff()：计算第一个数组与后面一个或多个数组之间的差集
• array_diff_assoc()：计算第一个数组与后面一个或多个数组之间的差集，并比较键名是否相同
• array_diff_uassoc()：使用用户自定义的函数对两个数组的键值对进行比较，比较第一个数组与后面数组的差集
• array_udiff_assoc()：使用用户自定义的函数对两个数组的键值对进行比较，比较第一个数组与后面数组的差集
• array_udiff_uassoc()：使用用户自定义的函数对两个数组的键值对进行比较，比较第一个数组与后面数组的差集
• array_intersect()：计算第一个数组与后面一个或多个数组之间的交集
• array_intersect_assoc()：计算第一个数组与后面一个或多个数组之间的交集，同时会比较键名
• array_uintersect()：使用用户自定义的比较函数对两个数组的键值进行比较，比较第一个数组与其后的数组之间的交集
• array_uintersect_assoc()：使用用户自定义的函数对两个数组的键值对进行比较，比较第一个数组与后面数组的交集
• array_uintersect_uassoc()：使用用户自定义的函数对两个数组的键值对进行比较，比较第一个数组与后面数组的交集