List<E> 类 抽象 接口

具有长度的可索引对象集合。

此类的子类实现了不同类型的列表。最常见的列表类型有

• 固定长度列表

  尝试使用可能改变列表长度的操作时将发生错误。

• 可增长列表

  此类中定义的 API 的完整实现。

默认的可增长列表（由 [] 创建）保留一个内部缓冲区，并在必要时增长该缓冲区。这保证了add操作序列中的每个操作都以摊销常数时间执行。直接设置长度可能需要与新长度成比例的时间，并且可能会更改内部容量，以便后续的添加操作需要立即增加缓冲区容量。其他列表实现可能有不同的性能行为。

固定长度列表示例

final fixedLengthList = List<int>.filled(5, 0); // Creates fixed-length list.
print(fixedLengthList); // [0, 0, 0, 0, 0]
fixedLengthList[0] = 87;
fixedLengthList.setAll(1, [1, 2, 3]);
print(fixedLengthList); // [87, 1, 2, 3, 0]
// Fixed length list length can't be changed or increased
fixedLengthList.length = 0;  // Throws
fixedLengthList.add(499);    // Throws

可增长列表示例

final growableList = <String>['A', 'B']; // Creates growable list.

要将数据添加到可增长列表中，请使用 操作符[]、add 或 addAll。

growableList[0] = 'G';
print(growableList); // [G, B]
growableList.add('X');
growableList.addAll({'C', 'B'});
print(growableList); // [G, B, X, C, B]

要检查元素是否在列表中，以及其在列表中的位置，请使用 indexOf 或 lastIndexOf。

final indexA = growableList.indexOf('A'); // -1 (not in the list)
final firstIndexB = growableList.indexOf('B'); // 1
final lastIndexB = growableList.lastIndexOf('B'); // 4

要从可增长列表中删除元素，请使用 remove、removeAt、removeLast、removeRange 或 removeWhere。

growableList.remove('C');
growableList.removeLast();
print(growableList); // [G, B, X]

要将元素插入列表中的某个位置，请使用 insert 或 insertAll。

growableList.insert(1, 'New');
print(growableList); // [G, New, B, X]

要替换列表中的元素范围，请使用 fillRange、replaceRange 或 setRange。

growableList.replaceRange(0, 2, ['AB', 'A']);
print(growableList); // [AB, A, B, X]
growableList.fillRange(2, 4, 'F');
print(growableList); // [AB, A, F, F]

要排序列表中的元素，请使用 sort。

growableList.sort((a, b) => a.compareTo(b));
print(growableList); // [A, AB, F, F]

要随机洗牌此列表的元素，请使用 shuffle。

growableList.shuffle();
print(growableList); // e.g. [AB, F, A, F]

要找到满足某些谓词的第一个元素，或者如果没有元素满足，则返回默认值，请使用 firstWhere。

bool isVowel(String char) => char.length == 1 && "AEIOU".contains(char);
final firstVowel = growableList.firstWhere(isVowel, orElse: () => ''); // ''

存在类似的 lastWhere 和 singleWhere 方法。

列表是 Iterable，并支持其所有方法，包括 where、map、whereType 和 toList。

列表是 Iterable。迭代按索引顺序进行。更改值不会影响迭代，但更改有效索引（即更改列表的长度）会在迭代步骤之间导致 ConcurrentModificationError。这意味着只有可增长列表可以抛出 ConcurrentModificationError。如果长度临时更改并在继续迭代之前恢复，迭代器可能不会检测到它。

通常情况下，在列表操作进行时（例如在调用forEach或sort时），不允许修改列表的长度（添加或删除元素）。如果在迭代列表时改变其长度，无论是直接迭代还是通过迭代基于列表的Iterable，都会中断迭代。