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

# 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
    )

### 注意

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

### 参考

- array_fill_keys() - キーを指定して、配列を値で埋める
- str_repeat() - 文字列を反復する
- range() - ある範囲の整数を有する配列を作成する