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

# array_fill

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

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

### Описание

function 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() - Создаёт массив, который содержит диапазон элементов

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open