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, キー, 生成, values, , combine, 要素, バージョン, スロー