array_pad
(PHP 4, PHP 5)
array_pad — 用值将数组填补到指定长度
说明
array array_pad
( array $input
, int $pad_size
, mixed $pad_value
)
array_pad() 返回
input 的一个拷贝，并用
pad_value 将其填补到
pad_size 指定的长度。如果
pad_size 为正，则填补到数组的右侧，如果为负则从左侧开始填补。如果
pad_size 的绝对值小于或等于
input 数组的长度则没有任何填补。有可能一次最多填补
1048576 个单元。
参数
input
需要被填充的原始数组。
pad_size
新数组的长度。
pad_value
将被填充的值，只有在 input 的现有长度小于
pad_size 的长度时才有效。
返回值
返回 input 用 pad_value 填充到 pad_size 指定的长度之后的一个副本。
如果 pad_size 为正，则填补到数组的右侧，如果为负则从左侧开始填补。
如果 pad_size 的绝对值小于或等于 input 数组的长度则没有任何填补。
范例
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() - 建立一个包含指定范围单元的数组