大网数据广告活动
PHP 语言与运行手册

array_fill · 用给定的值填充数组

· 52CE 我爱测

用 value 参数的值填充 count 个元素到数组, 开始键名由 start_index 参数指定。

array_fill

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

array_fill — 用给定的值填充数组

说明

function array_fill(int $start_index, int $count, mixed $value): array

用 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 8 中的输出:

Array
(
    [-2] => pear
    [-1] => pear
    [0] => pear
    [1] => pear
)

以上示例在 PHP 7 中的输出:

Array
(
    [-2] => pear
    [0] => pear
    [1] => pear
    [2] => pear
)

注意 索引 -1 在 PHP 8.0.0 之前不存在。

注释

参见手册上数组一节里关于负数的键的详细解释。

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。