Expande um array para um certo comprimento utilizando um determinado valor

Descrição

array_pad(array $array, int $length, mixed $value): array

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.

Parâmetros

array: Array inicial de valores para ser preenchido.
length: Nova tamanho do array.
value: Valor para preencher se array é menor que length.

Valor Retornado

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.

Registro de Alterações

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.

Exemplos

Example #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() - Preenche um array com valores
range() - Cria um array contendo uma faixa de elementos