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