Função array_pad

A função array_pad preenche um array com um determinado valor até um tamanho especificado. O primeiro parâmetro da função é o array a ser preenchido, o segundo parâmetro - até qual tamanho preencher, o terceiro - com o que preencher.

O segundo parâmetro pode ser negativo - neste caso, o array será preenchido com elementos não no final, mas no início.

Sintaxe

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

Exemplo

Vamos preencher o array com zeros para que seu tamanho se torne 7 elementos:

php<?php
  $arr = ['a', 'b', 'c', 'd', 'e'];
  
  $res = array_pad($arr, 7, 0);
  var_dump($res);
?>

Resultado da execução do código:

php['a', 'b', 'c', 'd', 'e', 0, 0]

Exemplo

Agora o array já tem 7 elementos - portanto não será preenchido com nada:

php<?php
  $arr = ['a', 'b', 'c', 'd', 'e', 'f', 'g'];
  
  $res = array_pad($arr, 7, 0);
  var_dump($res);
?>

Resultado da execução do código:

php['a', 'b', 'c', 'd', 'e', 'f', 'g']

Exemplo

Vamos tornar o segundo parâmetro negativo. Neste caso, o array será preenchido no início, e não no final:

php<?php
  $arr = ['a', 'b', 'c', 'd', 'e'];
  
  $res = array_pad($arr, -7, 0);
  var_dump($res);
?>

Resultado da execução do código:

php[0, 0, 'a', 'b', 'c', 'd', 'e']

Veja também