定義和用法
array_udiff_uassoc() 函數用於比較兩個(或更多個)數組的鍵名和鍵值,並返回差集。
注釋:該函數使用兩個用戶自定義函數進行比較;第一個函數比較鍵名,第二個函數比較鍵值!
該函數比較兩個(或更多個)數組的鍵名和鍵值,並返回一個差集數組,該數組包括了所有在被比較的數組(array1)中,但是不在任何其他參數數組(array2 或 array3 等等)中的鍵名和鍵值。
說明
array_udiff_uassoc() 函數返回 array1 數組中存在但其它數組中都不存在的部分。返回的數組中鍵名保持不變。
注意與 array_diff() 以及 array_udiff() 不同的是鍵名也用於比較。同時進行鍵名和鍵值的比較,如 "a"=>1 和 "b"=>1 這兩個元素是不相等的。
對鍵名(索引)的檢查也是由回調函數 myfunction_key 進行的。這和 array_udiff_assoc() 的行為不同,后者是用內部函數比較索引的。
數組數據的比較是使用用戶提供的回調函數 myfunction_value 進行的。在此方面和 array_diff_assoc() 的行為正好相反,后者是用內部函數進行比較的。
這兩個函數都帶有兩個將進行比較的參數。如果第一個參數小於第二個參數,則函數返回一個負數,如果兩個參數相等,則要返回 0,如果第一個參數大於第二個,則返回一個正數。
語法
array_udiff_uassoc(array1,array2,array3...,myfunction_key,myfunction_value)
| 參數 | 描述 |
|---|---|
| array1 | 必需。與其他數組進行比較的第一個數組。 |
| array2 | 必需。與第一個數組進行比較的數組。 |
| array3,... | 可選。與第一個數組進行比較的其他數組。 |
| myfunction_key | 必需。用於比較數組鍵名的用戶自定義函數的名稱。 字符串值,定義可調用的比較函數。如果第一個參數小於等於或大於第二個參數,則比較函數必須返回小於等於或大於 0 的整數。 |
| myfunction_value | 必需。用於比較數組鍵值的用戶自定義函數的名稱。 字符串值,定義可調用的比較函數。如果第一個參數小於等於或大於第二個參數,則比較函數必須返回小於等於或大於 0 的整數。 |
返回值:
返回差集數組,該數組包括了所有在被比較的數組(array1)中,但是不在任何其他參數數組(array2或 array3 等等)中的鍵名和鍵值。
實例:
<?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) 同時出現在兩個數組中,因此不在本函數的輸出中。要記住必須提供兩個回調函數。
