Preenche um array com valores

# array_fill

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

array_fill — Preenche um array com valores

### Descrição

function 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

- array_fill_keys() - Preenche um array com valores, especificando chaves
- str_repeat() - Repete uma string
- range() - Cria um array contendo uma faixa de elementos

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open