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

array_fill_keys() - Rellena un array con valores, especificando las claves
str_repeat() - Repite un string
range() - Crea un array que contiene un intervalo de elementos

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 6 notes

down

csst0266 at cs dot uoi dot gr ¶

21 years ago

This is what I recently did to quickly create a two dimensional array (10x10), initialized to 0:<?php  $a = array_fill(0, 10, array_fill(0, 10, 0));?>This should work for as many dimensions as you want, each time passing to array_fill() (as the 3rd argument) another array_fill() function.

down

anatoliy at ukhvanovy dot name ¶

11 years ago

If you need negative indices:<?php$b = array_fill(-2, 4, 'pear');//this is not what we want$c = array_fill_keys(range(-2,1),'pear');//these are negative indicesprint_r($b);print_r($c);?>Here is result of the code above:Array(    [-2] => pear    [0] => pear    [1] => pear    [2] => pear)Array(    [-2] => pear    [-1] => pear    [0] => pear    [1] => pear)

down

mchljnk at NOSPAM dot gmail dot com ¶

11 years ago

Using objects with array_fill may cause unexpected results. Consider the following:<?phpclass Foo {   public $bar = "banana";}//fill an array with objects$array = array_fill(0, 2, new Foo());var_dump($array);/*array(2) {  [0]=>  object(Foo)#1 (1) {    ["bar"]=>    string(6) "banana"  }  [1]=>  object(Foo)#1 (1) {    ["bar"]=>    string(6) "banana"  }} *///now we change the attribute of the object stored in index 0//this actually changes the attribute for EACH object in the ENTIRE array$array[0]->bar = "apple";var_dump($array);/*array(2) {  [0]=>  object(Foo)#1 (1) {    ["bar"]=>    string(5) "apple"  }  [1]=>  object(Foo)#1 (1) {    ["bar"]=>    string(5) "apple"  }} */?>Objects are filled in the array BY REFERENCE. They are not copied for each element in the array.

down

user at NOSPAM dot example dot com ¶

4 years ago

As of PHP 8.0 the example code<?php$b = array_fill(-2, 4, 'pear');print_r($b);?>now returnsArray(    [-2] => pear    [-1] => pear    [0] => pear    [1] => pear)See https://wiki.php.net/rfc/negative_array_index and https://github.com/php/php-src/pull/3772

down

miguelxpain at gmail dot com ¶

13 years ago

I made this function named "array_getMax" that returns te maximum value and index, from array:

<?php
//using array_search_all by helenadeus at gmail dot com

function array_search_all($needle, $haystack)
{#array_search_match($needle, $haystack) returns all the keys of the values that match $needle in $haystack

    foreach ($haystack as $k=>$v) {
   
        if($haystack[$k]==$needle){
       
           $array[] = $k;
        }
    }
    return ($array);

   
}

function array_getMax($array){
        
    $conteo=array_count_values($array);
    
    if( count($conteo)==1 ){//returns full array when all values are the same.
        return  $array;       
    }
       
    arsort($array);
    
    //$antValue=null;
    $maxValue=null;
    $keyValue=null;
    foreach($array as $key=>$value){
        if($maxValue==null){
            $maxValue=$value;
            $keyValue=$key;
            break;
        }        
    }
    
    $resultSearch=array_search_all($maxValue, $array);
        
   return  array_fill_keys($resultSearch, $maxValue);
    
    
}

//example 
  $arreglo=array('e1'=>99,'e2'=>'99','e3'=>1,'e4'=>1,'e5'=>98);
    
    var_dump(array_getMax($arreglo));

//output
/*
array(2) {
  ["e1"]=>
  int(99)
  ["e2"]=>
  int(99)
}
*/
?>

I hope some one find this usefull

down

-2

Hayley Watson ¶

7 years ago

Fill missing keys in a (numerically-indexed) array with a default value<?phpfunction fill_missing_keys($array, $default = null, $atleast = 0){    return $array + array_fill(0, max($atleast, max(array_keys($array))), $default);}?>

＋add a note