长度属性

int length
覆盖

此列表中对象的数量。

列表的有效索引范围是0到length - 1。

final numbers = <int>[1, 2, 3];
print(numbers.length); // 3

实现

int get length => JS("int", "#.length", this);
void length=(int value)
覆盖

设置length会改变列表中的元素数量。

列表必须可增长。如果newLength大于当前长度，新条目会被初始化为null，所以如果元素类型E是非空类型，则newLength必须不大于当前长度。

final maybeNumbers = <int?>[1, null, 3];
maybeNumbers.length = 5;
print(maybeNumbers); // [1, null, 3, null, null]
maybeNumbers.length = 2;
print(maybeNumbers); // [1, null]

final numbers = <int>[1, 2, 3];
numbers.length = 1;
print(numbers); // [1]
numbers.length = 5; // Throws, cannot add `null`s.

实现

set length(int value) {
  throw new UnsupportedError("Cannot resize immutable List.");
}