array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'en', ), 'this' => array ( 0 => 'function.array-fill.php', 1 => 'array_fill', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Array Functions', ), 'prev' => array ( 0 => 'function.array-fill-keys.php', 1 => 'array_fill_keys', ), 'next' => array ( 0 => 'function.array-filter.php', 1 => 'array_filter', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/array/functions/array-fill.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(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_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
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.