(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_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).
count
Número de elementos a insertar.
Debe ser mayor o igual a cero, y menor o igual a 2147483647
.
value
Valor 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.