array_pad

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

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

说明

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

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

参数

array

需要被填充的原始数组。

length

新数组的长度。

value

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

返回值

返回 arrayvalue 填充到 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)

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

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

参见

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