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ãoDescrição
    8.0.0array_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 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.

    Notas

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

    Veja Também

    To Top