PHP Conference Japan 2024

array_udiff_uassoc

(PHP 5, PHP 7, PHP 8)

array_udiff_uassoc使用額外的索引檢查計算陣列的差異,透過回呼函式比較資料和索引

說明

array_udiff_uassoc(
    陣列 $array,
    陣列 ...$arrays,
    可呼叫 $value_compare_func,
    可呼叫 $key_compare_func
): 陣列

計算陣列的差集,並額外檢查索引,透過回呼函式比較資料和索引。

請注意,不同於 array_diff()array_udiff(),此函式會在比較中使用鍵值。

參數

array

第一個陣列。

arrays

要比較之陣列。

value_compare_func

比較函式必須回傳一個整數。若第一個參數小於、等於或大於第二個參數,則分別回傳小於零、等於零或大於零的整數。

callback(混合 $a, 混合 $b): 整數
注意事項

從比較函式回傳*非整數*值,例如 浮點數,將導致回呼函式的回傳值被內部強制轉換為 整數。 因此,諸如 0.990.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

鍵值(索引)的比較也是由回呼函數 key_compare_func 完成的。這個行為與 array_udiff_assoc() 的行為不同,因為後者使用內部函數比較索引。

返回值

返回一個 陣列,其中包含 array 中所有在其他任何參數中不存在的值。

範例

範例 #1 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);
?>

上述範例將輸出

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) 鍵值對存在於兩個陣列中,因此它不在函數的輸出中。請記住,您必須提供 2 個回呼函數。

注意事項

注意 請注意,此函數僅檢查 n 維陣列的一個維度。當然,您可以使用例如 array_udiff_uassoc($array1[0], $array2[0], "data_compare_func", "key_compare_func"); 來檢查更深層的維度。

參見

新增註解

使用者貢獻的註解

此頁面沒有使用者貢獻的註解。
To Top