array_fill
(PHP 4 >= 4.2.0, PHP 5, PHP 7)
array_fill — Fill an array with values
Description
array_fill ( int $start_index , int $count , mixed $value ) : array
Fills an array with count
entries of the value of the value
parameter, keys starting at the start_index
parameter.
Parameters
-
start_index
-
The first index of the returned array.
If
start_index
is negative, the first index of the returned array will bestart_index
and the following indices will start from zero (see example). -
count
-
Number of elements to insert. Must be greater than or equal to zero.
-
value
-
Value to use for filling
Return Values
Returns the filled array
Errors/Exceptions
Throws a E_WARNING
if count
is less than zero.
Changelog
Version | Description |
---|---|
5.6.0 | count may now be zero. Previously, count was required to be greater than zero. |
Examples
Example #1 array_fill() example
<?php $a = array_fill(5, 6, 'banana'); $b = array_fill(-2, 4, 'pear'); print_r($a); print_r($b); ?>
The above example will output:
Array ( [5] => banana [6] => banana [7] => banana [8] => banana [9] => banana [10] => banana ) Array ( [-2] => pear [0] => pear [1] => pear [2] => pear )
Notes
See also the Arrays section of manual for a detailed explanation of negative keys.
See Also
- array_fill_keys() - Fill an array with values, specifying keys
- str_repeat() - Repeat a string
- range() - Create an array containing a range of elements
© 1997–2020 The PHP Documentation Group
Licensed under the Creative Commons Attribution License v3.0 or later.
https://www.php.net/manual/en/function.array-fill.php