array_combine

(PHP 5, PHP 7, PHP 8)

array_combine 一方の配列をキーとして、もう一方の配列を値として、ひとつの配列を生成する

説明

array_combine(array$keys, array$values): array

keys 配列の値をキーとして、また values 配列の値を対応する値として生成した 配列 を作成します。

パラメータ

keys

キーとして使用する配列。無効な値を渡すと文字列に変換されます。

values

値として使用する配列。

戻り値

作成した配列を返します。

エラー / 例外

PHP 8.0.0 以降では、keys および values の要素数が一致しなかった場合は ValueError がスローされます。 それより前のバージョンでは、 E_WARNING が発生していました。

変更履歴

バージョン説明
8.0.0 それぞれの配列の要素数が一致しなかった場合、 array_combine()ValueError をスローするようになりました。 これより前のバージョンでは、false を返していました。

例1 array_combine()の簡単な例

<?php
$a
= array('green', 'red', 'yellow');
$b = array('avocado', 'apple', 'banana');
$c = array_combine($a, $b);

print_r($c);
?>

上の例の出力は以下となります。

Array ( [green] => avocado [red] => apple [yellow] => banana )

参考

  • array_merge() - ひとつまたは複数の配列をマージする
  • array_walk() - 配列の全ての要素にユーザー定義の関数を適用する
  • array_values() - 配列の全ての値を返す
  • array_map() - 指定した配列の要素にコールバック関数を適用する
To Top