array_multisort
array_pop
Funções para Array
PHP Manual

# array_pad

(PHP 4, PHP 5)

array_pad — Expande um array para um certo comprimento utilizando um determinado valor

### Descrição

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

array_pad() retorna uma cópia de `input` expandido para o comprimento especificado por `pad_size` com o valor `pad_value` . Se `pad_size` for positivo então o array é expandido pela direita, se for negativo, pela esquerda. Se o valor absoluto de `pad_size` for menor ou igual ao comprimento de `input` , então ele permanece inalterado. É possível adicionar até 1048576 elementos de uma vez.

### Parâmetros

`input`

  Array inicial de valores para ser preenchido.

`pad_size`

  Nova tamanho do array.

`pad_value`

  Valor para preencher se `input` é menor que `pad_size` .

### Valor Retornado

Retorna uma cópia de `input` preenchido pela quantidade especificada por `pad_size` com o valor `pad_value` . Se `pad_size` é positivo, então o array é preenchido na direita, se ele é negativo, então da esquerda. Se o valor absoluto de pad_size é menor que ou igual ao tamanho da entrada, então nenhum preenchimento ocorre.

### Exemplos

Exemplo #1 Exemplo de 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");
// Não será expandido
?>`

### Veja Também

- array_fill()
- range()

array_multisort
array_pop
Funções para Array
PHP Manual