# array_pad

(PHP 4, PHP 5, PHP 7)

array_pad — 以指定长度将一个值填充进数组

### 说明

array_pad ( array `$array` , int `$size` , mixed `$value` ) : array

array_pad() 返回 `array` 的一个拷贝，并用 `value` 将其填补到 `size` 指定的长度。如果 `size` 为正，则填补到数组的右侧，如果为负则从左侧开始填补。如果 `size` 的绝对值小于或等于 `array` 数组的长度则没有任何填补。有可能一次最多填补 1048576 个单元。

### 参数

`array`

  需要被填充的原始数组。

`size`

  新数组的长度。

`value`

  将被填充的值，只有在 `array` 的现有长度小于 `size` 的长度时才有效。

### 返回值

返回 `array` 用 `value` 填充到 `size` 指定的长度之后的一个副本。 如果 `size` 为正，则填补到数组的右侧，如果为负则从左侧开始填补。 如果 `size` 的绝对值小于或等于 `array` 数组的长度则没有任何填补。

### 范例

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() - 根据范围创建数组，包含指定的元素