(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
Количество добавляемых элементов.
Должно быть больше или равно нулю и меньше или равно 2147483647.
valueЗначение для заполнения.
Возвращает заполненный массив.
Выбрасывает исключение ValueError в случае, если
параметр count выходит за пределы диапазона.
| Версия | Описание |
|---|---|
| 8.0.0 |
Функция array_fill() теперь выбрасывает исключение ValueError,
если параметр count выходит за пределы диапазона;
ранее выдавалась ошибка уровня E_WARNING,
а функция возвращала значение false.
|
Пример #1 Пример использования array_fill()
<?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() с отрицательным начальным индексом
<?php
$a = array_fill(-2, 4, 'pear');
print_r($a);
?>Результат выполнения данного примера в PHP 7:
Array
(
[-2] => pear
[0] => pear
[1] => pear
[2] => pear
)
Результат выполнения данного примера в PHP 8:
Array
(
[-2] => pear
[-1] => pear
[0] => pear
[1] => pear
)
Обратите внимание, что индекс -1 отсутствует до PHP 8.0.0.
Смотрите также подробное описание отрицательных ключей в разделе Массивы.