array_udiff_assoc
(PHP 5)
array_udiff_assoc -- データの比較にコールバック関数を用い、
追加された添字の確認を含めて配列の差を計算する
説明
array
array_udiff_assoc ( array array1, array array2 [, array ..., callback data_compare_func] )
array_udiff_assoc() は、
array1 から他の引数の配列の中に現れない全ての値を含む
array を返します。
array_diff() や array_udiff()
と異なり、キーが比較に使用されることに注意してください。
配列のデータの比較は、ユーザが指定したコールバックを用いて行われます。
この点で、array_diff_assoc() は反対の動作、つまり
内部関数を利用した比較を行います。
例 1. array_udiff_assoc() の例
<?php
class cr {
private $priv_member;
function cr($val)
{
$this->priv_member = $val;
}
function comp_func_cr($a, $b)
{
if ($a->priv_member === $b->priv_member) return 0;
return ($a->priv_member > $b->priv_member)? 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_assoc($a, $b, array("cr", "comp_func_cr"));
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) の組み合わせが両方の配列にあること、
そしてそれが関数の出力に含まれていないことが確認できます。
比較は、ユーザが指定したコールバック関数を用いて行います。
この関数は、1 つめの引数が 2 つめより小さい / 等しい / 大きい
場合にそれぞれ 負の数 / ゼロ / 正の数 を返す必要があります。
注意:
この関数は n 次元配列の一つの次元しかチェックしないことに注意してください。
もちろん、array_udiff_assoc($array1[0], $array2[0], "some_comparison_func");
のようにすることでより深い次元でのチェックもできます。
array_diff()、
array_diff_assoc()、
array_diff_uassoc()、
array_udiff()、
array_udiff_uassoc()、
array_intersect()、
array_intersect_assoc()、
array_uintersect()、
array_uintersect_assoc() および
array_uintersect_uassoc() も参照ください。