array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.array-fill.php', 1 => 'array_fill', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Funções para Array', ), 'prev' => array ( 0 => 'function.array-fill-keys.php', 1 => 'array_fill_keys', ), 'next' => array ( 0 => 'function.array-filter.php', 1 => 'array_filter', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/array/functions/array-fill.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(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 7:
Array ( [-2] => pera [0] => pera [1] => pera [2] => pera )
Saída do exemplo acima no PHP 8:
Array ( [-2] => pera [-1] => pera [0] => pera [1] => 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.