(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.
Подробное описание отрицательных ключей дано в разделе «Массивы».