array_fill

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

array_fillЗаполняет массив значениями

Описание

array_fill(int $start_index, int $count, mixed $value): array

Функция заполняет массив значениями 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.

Примечания

Подробное описание отрицательных ключей приводит раздел «Массивы».

Смотрите также

  • array_fill_keys() - Создаёт массив и заполняет его значениями с определёнными ключами
  • str_repeat() - Возвращает повторяющуюся строку
  • range() - Создаёт массив, который содержит диапазон элементов