(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
array_fill — Fill an array with values
Fills an array with count entries of the value of the value parameter, keys starting at the start_index parameter.
start_indexThe 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.
valueValue to use for filling
Returns the filled array
Throws a ValueError if count is out of range.
| 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. |
Example #1 array_fill() example
<?php
$a = array_fill(5, 6, 'banana');
print_r($a);
?>The above example will output:
Array ( [5] => banana [6] => banana [7] => banana [8] => banana [9] => banana [10] => banana )
Example #2 array_fill() example with a negative start index
<?php
$a = array_fill(-2, 4, 'pear');
print_r($a);
?>Output of the above example in PHP 7:
Array ( [-2] => pear [0] => pear [1] => pear [2] => pear )
Output of the above example in PHP 8:
Array ( [-2] => pear [-1] => pear [0] => pear [1] => pear )
Note that index -1 is not present prior to PHP 8.0.0.
See also the Arrays section of manual for a detailed explanation of negative keys.