array_fill
(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
array_fill — Заполняет массив значениями
Список параметров
start_index
-
Первый индекс возвращаемого массива.
Если начальный ключ start_index
будет отрицательным,
первым индексом возвращаемого массива будет
значение этого отрицательного ключа (start_index
), а следующие индексы
будут начинаться с нуля до PHP 8.0.0;
начиная с PHP 8.0.0 отрицательные ключи увеличиваются нормально
(смотрите пример).
count
-
Количество добавляемых элементов.
Должно быть больше или равно нулю и меньше или равно 2 147 483 647
.
value
-
Значение для заполнения.
Возвращаемые значения
Возвращает заполненный массив.
Ошибки
Выбрасывает исключение ValueError, если
параметр count
выходит за пределы диапазона.
Примеры
Пример #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
.
Примечания
Подробное описание отрицательных ключей дано в разделе
«Массивы».
Смотрите также
- array_fill_keys() - Создаёт массив и заполняет его значениями с определёнными ключами
- str_repeat() - Возвращает повторяющуюся строку
- range() - Создаёт массив, который содержит диапазон элементов