(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.
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.
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
?>