(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_indexO 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.
valueValores 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.