length属性

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.");
}