(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
array_fill — Preenche um array com valores
Preenche um array com
count
elementos com o valor do
parâmetro value
e chaves começando a partir de
start_index
.
start_index
O primeiro índice do array retornado
Se start_index
for negativo,
o primeiro índice do array retornado será
start_index
, e os índices
seguintes começarão do zero antes do PHP 8.0.0.
A partir do PHP 8.0.0, chaves negativas são incrementadas normalmente
(veja o exemplo).
count
Número de elementos a inserir.
Deve ser maior ou igual a zero, e menor ou igual a 2147483647
.
value
Valores a preencher
Retorna o array preenchido
Lança um ValueError se count
estiver
fora do alcance.
Versão | Descrição |
---|---|
8.0.0 |
array_fill() agora lança um ValueError
se count estiver fora de alance; anteriormente um E_WARNING
era disparado, e a função retornava false .
|
Exemplo #1 Exemplo da função array_fill()
<?php
$a = array_fill(5, 6, 'banana');
print_r($a);
?>
O exemplo acima produzirá:
Array ( [5] => banana [6] => banana [7] => banana [8] => banana [9] => banana [10] => banana )
Exemplo #2 Exemplo da array_fill() com um índice de início negativo
<?php
$a = array_fill(-2, 4, 'pera');
print_r($a);
?>
Saída do exemplo acima no PHP 8:
Array ( [-2] => pera [-1] => pera [0] => pera [1] => pera )
Saída do exemplo acima no PHP 7:
Array ( [-2] => pera [0] => pera [1] => pera [2] => pera )
Note que o índice -1
não está presente antes do PHP 8.0.0.
Veja também a seção Arrays do manual para a explicação detalhada de chaves negativas.