Php/docs/function.array-pad

来自菜鸟教程
跳转至:导航、​搜索

array_pad

(PHP 4, PHP 5, PHP 7)

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 的长度时才有效。


返回值

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


范例

Example #1 array_pad() 例子

<?php$input = array(12, 10, 9);$result = array_pad($input, 5, 0);// 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($input, 2, "noop");// not padded?>

参见

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