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