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() – 建立一个包含指定范围单元的数组