array_pad
(PHP 4, PHP 5, PHP 7, PHP 8)
array_pad — 以指定長度將一個值填充進陣列
說明
array_pad() 返回 array 的一個拷貝，並用 value 將其填補到 length 指定的長度。如果 length 為正，則填補到陣列的右側，如果為負則從左側開始填補。如果 length 的絕對值小於或等於 array 陣列的長度則沒有任何填補。有可能一次最多填補
1048576 個單元。
參數
-
array 需要被填充的原始陣列。
-
length 新陣列的長度。
-
value 將被填充的值，只有在
array的現有長度小於length的長度時才有效。
返回值
返回 array 用 value 填充到 length 指定的長度之後的一個副本。如果 length 為正，則填補到陣列的右側，如果為負則從左側開始填補。如果 length 的絕對值小於或等於 array 陣列的長度則沒有任何填補。
範例
示例 #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");
// 沒有填充
?> 參見
- array_fill() - 用給定的值填充陣列
- range() - 根據範圍建立陣列，包含指定的元素