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
Заповнює масив заданим у параметрі count кількістю записів значення value, починаючи індексацію з ключа 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()****
Результат виконання наведеного прикладу:
Array
(
[5] => банан
[6] => банан
[7] => банан
[8] => банан
[9] => банан
[10] => банан
)
Приклад #2 Приклад використання функції array_fill()** з негативним початковим індексом**
Результат виконання наведеного прикладу в 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() - Створює масив, що містить діапазон елементів