(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)
$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
?>