array_udiff_uassoc

(PHP 5, PHP 7, PHP 8)

array_udiff_uassoc — 帶索引檢查計算數組的差集，用回調函數比較數據和索引

說明

array_udiff_uassoc(
    array $array,
    array ...$arrays,
    callable $value_compare_func,
    callable $key_compare_func
): array

array_udiff_uassoc() 返回一個數組，該數組包括了所有在 array1 中但是不在任何其它參數數組中的值。

注意和 array_diff() 與 array_udiff() 不同的是鍵名也用于比較。

參數

array

第一個數組。

arrays

要比較的數組。

value_compare_func

在第一個參數小于，等于或大于第二個參數時，該比較函數必須相應地返回一個小于，等于或大于 0 的整數。

callback(mixed $a, mixed $b): int
key_compare_func

對鍵名（索引）的檢查也是由回調函數 key_compare_func 進行的。這和 array_udiff_assoc() 的行為不同，后者是用內部函數比較索引的。

返回值

返回一個 array，包含 array 里沒有出現在其他參數里的所有值。

范例

示例 #1 array_udiff_uassoc() 例子

<?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;
    }

    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
        )
)

在上例中鍵值對 "1" => new cr(4) 同時出現在兩個數組中，因此不在本函數的輸出中。要記住必須提供兩個回調函數。

注釋

注意: 注意本函數只檢查了多維數組中的一維。當然，可以用 array_udiff_uassoc($array1[0], $array2[0], "data_compare_func", "key_compare_func"); 來檢查更深的維度。

參見