array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.array-fill.php', 1 => 'array_fill', 2 => 'Rellena un array con un mismo valor', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Funciones de Arrays', ), 'prev' => array ( 0 => 'function.array-diff-ukey.php', 1 => 'array_diff_ukey', ), 'next' => array ( 0 => 'function.array-fill-keys.php', 1 => 'array_fill_keys', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/array/functions/array-fill.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

array_fill

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

array_fill — Rellena un array con un mismo valor

Descripción

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

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).

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 #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.

Ver también