array_fill
(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
array_fill — Rellena un array con un mismo valor
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).
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.
Ejemplos
Ejemplo #1 Ejemplo con array_fill()
<?php
$a = array_fill(5, 6, 'banana');
print_r($a);
?>
El ejemplo anterior mostrará :
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);
?>
Resultado del ejemplo anterior en PHP 8 :
Array
(
[-2] => pear
[-1] => pear
[0] => pear
[1] => pear
)
Resultado del ejemplo anterior en PHP 7 :
Array
(
[-2] => pear
[0] => pear
[1] => pear
[2] => pear
)
Observe que el índice -1
no estaba presente antes de PHP 8.0.0.
Notas
Ver también la sección del manual sobre los
arrays
para más información sobre las claves negativas.