(PHP 5, PHP 7, PHP 8)
array_udiff_uassoc — 使用額外的索引檢查計算陣列的差異,透過回呼函式比較資料和索引
array
第一個陣列。
arrays
要比較之陣列。
value_compare_func
比較函式必須回傳一個整數。若第一個參數小於、等於或大於第二個參數,則分別回傳小於零、等於零或大於零的整數。
從比較函式回傳*非整數*值,例如 浮點數,將導致回呼函式的回傳值被內部強制轉換為 整數。 因此,諸如 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
鍵值(索引)的比較也是由回呼函數 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");
來檢查更深層的維度。