array_pad

(PHP 4, PHP 5, PHP 7, PHP 8)

array_pad 以指定長(zhǎng)度將一個(gè)值填充進(jìn)數(shù)組

說明

array_pad(array $array, int $length, mixed $value): array

array_pad() 返回 array 的一個(gè)拷貝,并用 value 將其填補(bǔ)到 length 指定的長(zhǎng)度。如果 length 為正,則填補(bǔ)到數(shù)組的右側(cè),如果為負(fù)則從左側(cè)開始填補(bǔ)。如果 length 的絕對(duì)值小于或等于 array 數(shù)組的長(zhǎng)度則沒有任何填補(bǔ)。有可能一次最多填補(bǔ) 1048576 個(gè)單元。

參數(shù)

array

需要被填充的原始數(shù)組。

length

新數(shù)組的長(zhǎng)度。

value

將被填充的值,只有在 array 的現(xiàn)有長(zhǎng)度小于 length 的長(zhǎng)度時(shí)才有效。

返回值

返回 arrayvalue 填充到 length 指定的長(zhǎng)度之后的一個(gè)副本。如果 length 為正,則填補(bǔ)到數(shù)組的右側(cè),如果為負(fù)則從左側(cè)開始填補(bǔ)。如果 length 的絕對(duì)值小于或等于 array 數(shù)組的長(zhǎng)度則沒有任何填補(bǔ)。

范例

示例 #1 array_pad() 例子

<?php
$input 
= array(12109);

$result array_pad($input50);
// 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($input2"noop");
// 沒有填充
?>

參見

  • array_fill() - 用給定的值填充數(shù)組
  • range() - 根據(jù)范圍創(chuàng)建數(shù)組,包含指定的元素