array_fill

Fill an array with values

&reftitle.description; `array` `array_fill` `int` `start_index` `int` `count` `mixed` `value`

Fills an array with `count` entries of the value of the `value` parameter, keys starting at the `start_index` parameter.

&reftitle.parameters;

`start_index`

- The first index of the returned array.

  If `start_index` is negative, the first index of the returned array will be `start_index` and the following indices will start from zero prior to PHP 8.0.0; as of PHP 8.0.0, negative keys are incremented normally (see example).

`count`

- Number of elements to insert. Must be greater than or equal to zero, and less than or equal to `2147483647`.

`value`

- Value to use for filling

&reftitle.returnvalues;

Returns the filled array

&reftitle.errors;

Throws a `ValueError` if `count` is out of range.

&reftitle.changelog;

&Version; | &Description;
8.0.0 | `array_fill` now throws a `ValueError` if `count` is out of range; previously `E_WARNING` was raised, and the function returned &false;.

&reftitle.examples;

### `array_fill` example

    <?php
    $a = array_fill(5, 6, 'banana');
    print_r($a);
    ?>

&example.outputs;

    Array
    (
        [5]  => banana
        [6]  => banana
        [7]  => banana
        [8]  => banana
        [9]  => banana
        [10] => banana
    )

### `array_fill` example with a negative start index

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

&example.outputs.8;

    Array
    (
        [-2] => pear
        [-1] => pear
        [0] => pear
        [1] => pear
    )

&example.outputs.7;

    Array
    (
        [-2] => pear
        [0] => pear
        [1] => pear
        [2] => pear
    )

Note that index `-1` is not present prior to PHP 8.0.0.

&reftitle.notes;

See also the Arrays section of manual for a detailed explanation of negative keys.

&reftitle.seealso;

- `array_fill_keys`
- `str_repeat`
- `range`