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_indexis negative, the first index of the returned array will bestart_indexand 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