length属性

int length
override

此列表中对象的个数。

列表的有效索引为0至length - 1。

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

实现

int get length => JS("int", "#.length", this);
void length=(int newLength)
override

设置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 newLength) {
  throw new UnsupportedError("Cannot resize immutable List.");
}