(PHP 4, PHP 5, PHP 7)
array_pad — Expande um array para um certo comprimento utilizando um determinado valor
array_pad() retorna uma cópia de
array expandido para o comprimento especificado por
size com o valor
value. Se
size for positivo então o array é
expandido pela direita, se for negativo, pela esquerda. Se o
valor absoluto de size for menor ou igual
ao comprimento de array, então ele permanece
inalterado.
É possível adicionar até 1048576 elementos de uma vez.
arrayArray inicial de valores para ser preenchido.
sizeNova tamanho do array.
value
Valor para preencher se input é menor que
pad_size.
Retorna uma cópia de array preenchido pela quantidade
especificada por size com o valor
value. Se size é
positivo, então o array é preenchido na direita, se ele é negativo, então
da esquerda. Se o valor absoluto de size é menor que ou igual ao
comprimento de array 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
?>