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 数组的长度则没有任何填补。有可能一次最多填补 1048576 个单元。

参数

array

需要被填充的原始数组。

length

新数组的长度。

value

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

返回值

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

范例

示例 #1 array_pad() 例子

<?php
$input 
= array(12109);

$result array_pad($input50);
// 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($input2"noop");
// 没有填充
?>

参见

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