(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
array_fill — Заполняет массив значениями
Функция заполняет массив значениями value
столько раз, сколько указали в параметре count,
начиная индексацию с ключа 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 8:
Array
(
[-2] => груша
[-1] => груша
[0] => груша
[1] => груша
)
Результат выполнения приведённого примера в PHP 7:
Array
(
[-2] => груша
[0] => груша
[1] => груша
[2] => груша
)
Обратите внимание, вывод до PHP 8.0.0 не содержит индекса -1.
Подробное описание отрицательных ключей приводит раздел «Массивы».