array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.array-fill.php', 1 => 'array_fill', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Функции для работы с массивами', ), 'prev' => array ( 0 => 'function.array-fill-keys.php', 1 => 'array_fill_keys', ), 'next' => array ( 0 => 'function.array-filter.php', 1 => 'array_filter', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/array/functions/array-fill.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
array_fill — Заполняет массив значениями
Заполняет массив заданным в параметре count
количеством записей значения value
, начиная индексацию
с ключа start_index
.
start_index
Первый индекс возвращаемого массива.
Если начальный ключ start_index
будет отрицательным,
первым индексом возвращаемого массива будет
значение этого отрицательного ключа (start_index
), а следующие индексы
будут начинаться с нуля до PHP 8.0.0;
начиная с PHP 8.0.0 отрицательные ключи увеличиваются нормально
(смотрите пример).
count
Количество добавляемых элементов.
Должно быть больше или равно нулю и меньше или равно 2 147 483 647
.
value
Значение для заполнения.
Возвращает заполненный массив.
Выбрасывает исключение ValueError, если
параметр count
выходит за пределы диапазона.
Версия | Описание |
---|---|
8.0.0 |
Функция array_fill() теперь выбрасывает исключение ValueError,
если параметр count выходит за пределы диапазона;
ранее выдавалась ошибка уровня E_WARNING ,
а функция возвращала значение false .
|
Пример #1 Пример использования функции array_fill()
<?php
$a = array_fill(5, 6, 'банан');
print_r($a);
?>
Результат выполнения приведённого примера:
Array ( [5] => банан [6] => банан [7] => банан [8] => банан [9] => банан [10] => банан )
Пример #2 Пример использования функции array_fill() с отрицательным начальным индексом
<?php
$a = array_fill(-2, 4, 'груша');
print_r($a);
?>
Результат выполнения приведённого примера в PHP 7:
Array ( [-2] => груша [0] => груша [1] => груша [2] => груша )
Результат выполнения приведённого примера в PHP 8:
Array ( [-2] => груша [-1] => груша [0] => груша [1] => груша )
Обратите внимание, вывод до PHP 8.0.0 не содержит индекс -1
.
Подробное описание отрицательных ключей дано в разделе «Массивы».