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', 2 => 'Preenche um array com valores', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Funções para Array', ), 'prev' => array ( 0 => 'function.array-diff-ukey.php', 1 => 'array_diff_ukey', ), 'next' => array ( 0 => 'function.array-fill-keys.php', 1 => 'array_fill_keys', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/array/functions/array-fill.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

array_fill

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

array_fill — Preenche um array com valores

Descrição

array_fill(int $start_index, int $count, mixed $value): array

Preenche um array com count elementos com o valor do parâmetro value e chaves começando a partir de start_index.

Parâmetros

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

Valor Retornado

Retorna o array preenchido

Erros/Exceções

Lança um ValueError se count estiver fora do alcance.

Registro de Alterações

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.

Exemplos

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.

Notas

Veja também a seção Arrays do manual para a explicação detalhada de chaves negativas.

Veja Também