array_pad

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

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

说明

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

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

参数

array

需要被填充的原始数组。

size

新数组的长度。

value

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

返回值

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

范例

示例 #1 array_pad() 例子

<?php
$input 
= array(12109);

$result array_pad($input50);
// result is array(12, 10, 9, 0, 0)

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

$result array_pad($input2"noop");
// not padded
?>

参见

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