array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'zh', ), 'this' => array ( 0 => 'function.array-fill.php', 1 => 'array_fill', ), 'up' => array ( 0 => 'ref.array.php', 1 => '数组 函数', ), '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' => 'zh', '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 — 用给定的值填充数组
用 value
参数的值填充 count
个元素到数组,
开始键名由 start_index
参数指定。
start_index
返回的数组的第一个索引值。
如果 start_index
是负数,在 PHP 8.0.0
之前,返回的数组的第一个索引是 start_index
,
而后面索引则从 0 开始;自 PHP 8.0.0 起,
负数键将会正常递增。(参见 例子)
count
要插入元素的数量。必须大于或等于 0 且小于或等于 2147483647
。
value
用来填充的值。
返回填充后的数组。
如果 count
超出范围,将会抛出 ValueError。
版本 | 说明 |
---|---|
8.0.0 |
如果 array_fill() 的 count
超出范围现在将会抛出 ValueError,
之前会引发 E_WARNING 且函数返回 false 。
|
示例 #1 array_fill() 例子
<?php
$a = array_fill(5, 6, 'banana');
print_r($a);
?>
以上示例会输出:
Array ( [5] => banana [6] => banana [7] => banana [8] => banana [9] => banana [10] => banana )
示例 #2 开始索引为负数的 array_fill() 示例
<?php
$a = array_fill(-2, 4, 'pear');
print_r($a);
?>
以上示例在 PHP 7 中的输出:
Array ( [-2] => pear [0] => pear [1] => pear [2] => pear )
以上示例在 PHP 8 中的输出:
Array ( [-2] => pear [-1] => pear [0] => pear [1] => pear )
注意 索引 -1
在 PHP 8.0.0 之前不存在。
参见手册上数组一节里关于负数的键的详细解释。