(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
array_fill — Rellena un array con un mismo valor
Crea un array con count entradas, todas con el valor
value. Los índices comienzan en el valor
start_index.
start_indexEl 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).
count
Número de elementos a insertar.
Debe ser mayor o igual a cero, y menor o igual a 2147483647.
valueValor a utilizar para rellenar el array.
Devuelve el array relleno.
Lanza una excepción ValueError si
count está fuera del rango permitido.
| Versión | Descripción |
|---|---|
| 8.0.0 |
La función array_fill() ahora lanza una ValueError
si count está fuera del rango permitido;
anteriormente se emitía una alerta de nivel E_WARNING, y la función devolvía false.
|
Ejemplo #1 Ejemplo con array_fill()
<?php
$a = array_fill(5, 6, 'banana');
print_r($a);
?>El resultado del ejemplo sería:
Array
(
[5] => banana
[6] => banana
[7] => banana
[8] => banana
[9] => banana
[10] => banana
)
Ejemplo #2 Ejemplo de array_fill() con un índice de inicio negativo
<?php
$a = array_fill(-2, 4, 'pear');
print_r($a);
?>Salida del ejemplo anterior en PHP 7:
Array
(
[-2] => pear
[0] => pear
[1] => pear
[2] => pear
)
Salida del ejemplo anterior en PHP 8:
Array
(
[-2] => pear
[-1] => pear
[0] => pear
[1] => pear
)
Tenga en cuenta que el índice -1 no está presente en versiones anteriores a PHP 8.0.0.
Véase también la sección del manual sobre los arrays para más información sobre las claves negativas.