# array_pad

(PHP 4, PHP 5)

array_pad — Pad array to the specified length with a value

### Description

array array_pad ( array `$input` , int `$pad_size` , mixed `$pad_value` )

array_pad() returns a copy of the `input` padded to size specified by `pad_size` with value `pad_value` . If `pad_size` is positive then the array is padded on the right, if it's negative then on the left. If the absolute value of `pad_size` is less than or equal to the length of the `input` then no padding takes place. It is possible to add most 1048576 elements at a time.

### Parameters

`input`

  Initial array of values to pad.

`pad_size`

  New size of the array.

`pad_value`

  Value to pad if `input` is less than `pad_size` .

### Return Values

Returns a copy of the `input` padded to size specified by `pad_size` with value `pad_value` . If `pad_size` is positive then the array is padded on the right, if it's negative then on the left. If the absolute value of pad_size is less than or equal to the length of the input then no padding takes place.

### Examples

Example#1 array_pad() example

`<?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
?>`

### See Also

- array_fill()
- range()