array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'zh', ), 'this' => array ( 0 => 'function.array-pad.php', 1 => 'array_pad', ), 'up' => array ( 0 => 'ref.array.php', 1 => '数组 函数', ), 'prev' => array ( 0 => 'function.array-multisort.php', 1 => 'array_multisort', ), 'next' => array ( 0 => 'function.array-pop.php', 1 => 'array_pop', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'zh', 'path' => 'reference/array/functions/array-pad.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
array_pad — 以指定长度将一个值填充进数组
array_pad() 返回
array
的一个拷贝,并用
value
将其填补到
length
指定的长度。如果
length
为正,则填补到数组的右侧,如果为负则从左侧开始填补。如果
length
的绝对值小于或等于
array
数组的长度则没有任何填补。
array
需要被填充的原始数组。
length
新数组的长度。
value
将被填充的值,只有在 array
的现有长度小于
length
的长度时才有效。
返回 array
用 value
填充到 length
指定的长度之后的一个副本。如果 length
为正,则填补到数组的右侧,如果为负则从左侧开始填补。如果
length
的绝对值小于或等于 array
数组的长度则没有任何填补。
版本 | 说明 |
---|---|
8.3.0 | 在 8.3 版本之前,一次只能添加 1048576 个元素。 现在,它只受数组最大大小的限制。 |
示例 #1 array_pad() 例子
<?php
$input = array(12, 10, 9);
$result = array_pad($input, 5, 0);
// 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($input, 2, "noop");
// 没有填充
?>