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
array_pad(array $array, int $length, mixed $value): array
Exemplo
Vamos preencher o array com zeros para que
seu tamanho se torne 7 elementos:
<?php
$arr = ['a', 'b', 'c', 'd', 'e'];
$res = array_pad($arr, 7, 0);
var_dump($res);
?>
Resultado da execução do código:
['a', 'b', 'c', 'd', 'e', 0, 0]
Exemplo
Agora o array já tem 7 elementos
- portanto não será preenchido com nada:
<?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:
['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
$arr = ['a', 'b', 'c', 'd', 'e'];
$res = array_pad($arr, -7, 0);
var_dump($res);
?>
Resultado da execução do código:
[0, 0, 'a', 'b', 'c', 'd', 'e']
Veja também
-
a função
array_fill,
que preenche um array com um valor especificado -
a função
range,
que cria um array com uma faixa de elementos
