Spec-Zone.ru › Dart 2

dart:core

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

  1. @Deprecated("Используйте литерал списка, [], или конструктор List.filled вместо этого")
List<E>(
  1. [int? length]
)

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

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

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

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

Список имеет длину 0 и изменяемый, если length опущен.

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]);

© 2012 the Dart project authors
Licensed under the BSD 3-Clause "New" or "Revised" License.
https://api.dart.dev/stable/2.18.5/dart-core/List/List.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API