array_fill

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

array_fill — Fill an array with values

Опис

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

Fills an array with count entries of the value of the value parameter, keys starting at the start_index parameter.

Параметри

start_index

The first index of the returned array.

If start_index is negative, the first index of the returned array will be start_index and the following indices will start from zero prior to PHP 8.0.0; as of PHP 8.0.0, negative keys are incremented normally (see example).

count

Number of elements to insert. Must be greater than or equal to zero, and less than or equal to 2147483647.

value

Value to use for filling

Значення, що повертаються

Returns the filled array

Помилки/виключення

Throws a ValueError if count is out of range.

Журнал змін

Версія	Опис
8.0.0	array_fill() now throws a ValueError if `count` is out of range; previously `E_WARNING` was raised, and the function returned `false`.

Приклади

Приклад #1 array_fill() example

<?php
$a = array_fill(5, 6, 'banana');
print_r($a);
?>

Поданий вище приклад виведе:

Array
(
    [5] => banana
    [6] => banana
    [7] => banana
    [8] => banana
    [9] => banana
    [10] => banana
)

Приклад #2 array_fill() example with a negative start index

<?php
$a = array_fill(-2, 4, 'pear');
print_r($a);
?>

В PHP 8 поданий вище приклад виведе:

Array
(
    [-2] => pear
    [-1] => pear
    [0] => pear
    [1] => pear
)

В PHP 7 поданий вище приклад виведе:

Array
(
    [-2] => pear
    [0] => pear
    [1] => pear
    [2] => pear
)

Note that index -1 is not present prior to PHP 8.0.0.

Примітки

See also the Arrays section of manual for a detailed explanation of negative keys.

Прогляньте також

array_fill_keys() - Fill an array with values, specifying keys
str_repeat() - Repeat a string
range() - Створює масив, який містить послідовність елементів

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 ¶

22 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 ¶

12 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 indices
print_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 ¶

12 years ago

Using objects with array_fill may cause unexpected results. Consider the following:

<?php
class 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 ¶

5 years ago

As of PHP 8.0 the example code

<?php
$b = array_fill(-2, 4, 'pear');
print_r($b);
?>

now returns

Array
(
    [-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