PHPのarray_intersect_uassoc()関数とは？使い方をわかりやすく解説

PHPのarray_intersect_uassoc()関数は、複数の配列のキーと値を比較し、その際にユーザーが定義したコールバック関数による追加チェックを行うことで、共通する要素を取得できる関数です。キーの比較方法を独自にカスタマイズしたい場合に便利です。

類似の関数であるarray_intersect_assoc()は内部で標準的な比較を行いますが、array_intersect_uassoc()では大文字・小文字の扱いなど、比較ロジックを自由に定義できる点が大きな違いです。

構文

array_intersect_uassoc(arr1, arr2, arr3, arr4, …, compare_func)

パラメータ

• arr1 − 比較の基準となる配列。必須。

• arr2 − 比較対象となる配列。必須。

• arr3 − さらに比較したい配列を追加できます。省略可能。

• arr4 − さらに比較したい配列を追加できます。省略可能。

• compare_func − 比較に使用するコールバック関数。この関数は、第一引数が第二引数よりも「小さい」「等しい」「大きい」と判断される場合に、それぞれ0より「小さい整数」「0」「大きい整数」を返す必要があります。

戻り値

array_intersect_uassoc()関数は、最初の配列の要素のうち、他のすべての配列にも同じキーと値の組み合わせで存在している要素のみを含む配列を返します。

使用例

<?php
function compare_func($a, $b) {
   if ($a === $b) {
      return 0;
   }
   return ($a > $b)? 1:-1;
}
$arr1 = array("a" => "laptop", "b" => "keyboard", "c" => "mouse");
$arr2 = array("d" => "laptop", "b" => "keyboard", "c" => "mouse");
$res = array_intersect_uassoc($arr1, $arr2, "compare_func");
print_r($res);
?>

出力結果

Array ( [b] => keyboard [c] => mouse )

解説

この例では、$arr1と$arr2を比較しています。値「laptop」は両方の配列に存在しますが、キーが「a」と「d」で異なるため、結果には含まれません。一方、「b => keyboard」と「c => mouse」はキーと値の両方が一致しているため、結果の配列に残ります。

このようにarray_intersect_uassoc()は、キーと値のペアが完全に一致する要素だけを抜き出したい場合に活用できる関数です。特に、比較条件をカスタムロジックで制御したい場面で役立ちます。