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

array_pad · 以指定长度将一个值填充进数组

· 52CE 我爱测

array_pad() 返回 array 的一个拷贝,并用 value 将其填补到 length 指定的长度。如果 length 为正,则填补到数组的右侧,如果为负则从左侧开始填补。如果 length 的绝对值小于或等于 array 数组的长度则没有任何填补。

array_pad

(PHP 4, PHP 5, PHP 7, PHP 8)

array_pad — 以指定长度将一个值填充进数组

说明

function array_pad(array $array, int $length, mixed $value): array

array_pad() 返回 array 的一个拷贝,并用 value 将其填补到 length 指定的长度。如果 length 为正,则填补到数组的右侧,如果为负则从左侧开始填补。如果 length 的绝对值小于或等于 array 数组的长度则没有任何填补。

参数

array

需要被填充的原始数组。

length

新数组的长度。

value

将被填充的值,只有在 array 的现有长度小于 length 的长度时才有效。

返回值

返回 array 用 value 填充到 length 指定的长度之后的一个副本。如果 length 为正,则填补到数组的右侧,如果为负则从左侧开始填补。如果 length 的绝对值小于或等于 array 数组的长度则没有任何填补。

更新日志

版本 说明
8.3.0 在 8.3 版本之前,一次只能添加 1048576 个元素。 现在,它只受数组最大大小的限制。

示例

示例 #1 array_pad() 例子

<?php
$input = array(12, 10, 9);

$result = array_pad($input, 5, 0);
// result 是 array(12, 10, 9, 0, 0)
echo join(', ', $result), PHP_EOL;

$result = array_pad($input, -7, -1);
// result 是 array(-1, -1, -1, -1, 12, 10, 9)
echo join(', ', $result), PHP_EOL;

$result = array_pad($input, 2, "noop");
// 没有填充
echo join(', ', $result), PHP_EOL;
?>

参见

  • array_fill() - 用给定的值填充数组
  • range() - 根据范围创建数组,包含指定的元素

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

资料来源与适用范围

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

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

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