(PHP 4, PHP 5, PHP 7, PHP 8)
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
length com o valor
value. Se
length for positivo então o array é
expandido pela direita, se for negativo, pela esquerda. Se o
valor absoluto de length for menor ou igual
ao comprimento de array, então ele permanece
inalterado.
arrayArray inicial de valores para ser preenchido.
lengthNova tamanho do array.
value
Valor para preencher se array é menor que
length.
Retorna uma cópia de array preenchido pela quantidade especificada
por length com o valor
value. Se length é
positivo, então o array é preenchido na direita, se ele é negativo, então
da esquerda. Se o valor absoluto de length é menor
que ou igual ao comprimento de array então nenhum
preenchimento ocorre.
| Versão | Descrição |
|---|---|
| 8.3.0 | Antes do PHP 8.3.0, somente 1.048.576 elementos podiam ser adicionados de uma vez. Agora é limitado apenas pelo tamanho máximo de um array. |
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)
echo join(', ', $result), PHP_EOL;
$result = array_pad($input, -7, -1);
// $result é array(-1, -1, -1, -1, 12, 10, 9)
echo join(', ', $result), PHP_EOL;
$result = array_pad($input, 2, "noop");
// Não será expandido
echo join(', ', $result), PHP_EOL;
?>