dart:core

Конструктор List<E>

Создаёт список заданной длины.

ПРИМЕЧАНИЕ: Этот конструктор нельзя использовать в коде с поддержкой null safety. Используйте List.filled, чтобы создать непустой список. Для этого требуется значение заполнения, которым будут инициализированы элементы списка. Чтобы создать пустой список, используйте [] для растущего списка или List.empty для списка фиксированной длины (или если возможность изменения длины определяется во время выполнения).

Созданный список имеет фиксированную длину, если указано length.

var fixedLengthList = List(3);
fixedLengthList.length;     // 3
fixedLengthList.length = 1; // Error

Если length не указано, длина списка равна 0, и его размер можно изменять.

var growableList = List();
growableList.length; // 0;
growableList.length = 3;

Чтобы создать растущий список заданной длины с типом элементов, допускающим значение null, просто присвойте длину сразу после создания:

List<SomeNullableType> growableList = []..length = 500;

Для типа элементов, не допускающего значение null, можно использовать следующий способ:

List<int> growableList = List<int>.filled(500, 0, growable: true);

Если length указано, оно не должно быть отрицательным или равным null.

Если тип элемента не допускает значение null, length не должно быть больше нуля.

Реализация

@Deprecated("Use a list literal, [], or the List.filled constructor instead")
external factory List([int? length]);