Библиотеки » Основная библиотека (dart:core) » List » insertRange

функция List::insertRange

Вставляет ряд новых элементов в список

Синтаксис

void
List.insertRange
(int start, int length, [E initialValue])

Передаваемые параметры

int start, int length, [E initialValue]

Возвращаемое значение

void

Описание

Метод insertRange позволяет вставить length новых элементов в список, начиная с индекса start. Длина массива при этом увеличивается на length, а значения новых элементов устанавливаются равными initialValue, либо null, если initialValue не указан.

Если длина length равна 0, то данный метод ничего не делает.

Если индекс start равен длине списка, данный метод вставляет элементы в конец списка.

  • В случае, если массив фиксированный длины, то, генерируется ошибка UnsupportedError
  • В случае, если длина length отрицательная, генерируется ошибка ArgumentError
  • В случае, если индекс start отрицательный, или start выходит за границы списка, генерируется ошибка RangeError

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

List::setRange - Копирует элементы из заданного списка в текущий
List::getRange - Возвращает ряд элементов списка
List::removeRange - Удаляет ряд элементов из списка

Официальная документация (английский)