array_fill

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

Crea un array con `count` entradas, todas con el valor `value`. Los índices comienzan con el valor `start_index`.

## Parámetros

`start_index`  
El primer índice del array devuelto.

Si `start_index` es negativo, el primer índice del array devuelto será `start_index`, seguido por índices comenzando en cero en versiones anteriores a PHP 8.0.0 ; a partir de PHP 8.0.0, los índices negativos se incrementan normalmente. (ver el '[ejemplo](#function.array-fill.example.negative-start-index)).

`count`  
Número de elementos a insertar. Debe ser superior o igual a cero, e inferior o igual a `2147483647`.

`value`  
Valor a utilizar para rellenar el array

## Valores devueltos

Devuelve el array rellenado.

## Errores/Excepciones

Lanza una excepción `ValueError` si `count` está fuera del rango permitido.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.0.0 | La función `array_fill` lanza ahora una `ValueError` si `count` está fuera del rango permitido; anteriormente se emitía una advertencia de nivel `E_WARNING` y la función devolvía `false`. |

## Ejemplos

Ejemplo con `array_fill`

El ejemplo anterior mostrará:

    Array
    (
        [5]  => banana
        [6]  => banana
        [7]  => banana
        [8]  => banana
        [9]  => banana
        [10] => banana
    )

Ejemplo de `array_fill` con un índice de inicio negativo

Array
(
    [-2] => pear
    [-1] => pear
    [0] => pear
    [1] => pear
)

Array
(
    [-2] => pear
    [0] => pear
    [1] => pear
    [2] => pear
)