dart:collection

Метод insert

Вставляет объект в позицию index в этом списке.

Это увеличивает длину списка на единицу и смещает все объекты на или после указанного индекса к концу списка.

Возникает ошибка, если index меньше 0 или больше длины. Возникает UnsupportedError , если список имеет фиксированную длину.

Исходный код

void insert(int index, E element) {
  RangeError.checkValueInInterval(index, 0, length, "index");
  if (index == this.length) {
    add(element);
    return;
  }
  // We are modifying the length just below the is-check. Without the check
  // Array.copy could throw an exception, leaving the list in a bad state
  // (with a length that has been increased, but without a new element).
  if (index is! int) throw new ArgumentError(index);
  this.length++;
  setRange(index + 1, this.length, this, index);
  this[index] = element;
}