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，将破坏迭代。