array_fill

(PHP 4 >= 4.2.0, PHP 5, PHP 7)

array_fill — 配列を指定した値で埋める

説明

array_fill ( int $start_index , int $num , mixed $value ) : array

パラメータ value を値とする num 個のエントリからなる配列を埋めます。 この際、キーは、start_index パラメータから開始します。

パラメータ

start_index

返される配列の最初のインデックス。

start_index が負の場合は、 返される配列の最初のインデックスが start_index となり、それ以降のインデックスはゼロから始まります (例を参照ください)。

num

挿入する要素数。 ゼロ以上の数でなければなりません。

value

要素に使用する値。

返り値

値を埋めた配列を返します。

エラー / 例外

num がゼロより小さい場合に E_WARNING が発生します。

変更履歴

バージョン 説明
5.6.0 num にゼロを指定できるようになりました。これより前のバージョンでは、 num には正の数しか指定できませんでした。

例

例1 array_fill() の例

<?php
$a = array_fill(5, 6, 'banana');
$b = array_fill(-2, 4, 'pear');
print_r($a);
print_r($b);
?>

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

Array
(
    [5]  => banana
    [6]  => banana
    [7]  => banana
    [8]  => banana
    [9]  => banana
    [10] => banana
)
Array
(
    [-2] => pear
    [0] => pear
    [1] => pear
    [2] => pear
)

注意

負の値をキーに指定した場合についての詳細な説明は、マニュアルの 配列 のセクションを参照ください。

参考