(PHP 4, PHP 5)
array_pad — Expande um array para um certo comprimento utilizando um determinado valor
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.
Array inicial de valores para ser preenchido.
Nova tamanho do array.
Valor para preencher se input é menor que pad_size.
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.
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
?>