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.

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() e range().