作者： 李俊才

邮箱 ：291148484@163.com

CSDN 主页：https://blog.csdn.net/qq_28550263?spm=1001.2101.3001.5343

本文地址：https://blog.csdn.net/qq_28550263/article/details/123322685

相关文章推荐：

• dart 语言中的 Set集合：https://blog.csdn.net/qq_28550263/article/details/123449765

1. 概述

2. 定长列表（Fixed-length list）

3. 可增长列表（Growable list）

4. 不可变列表（unmodifiable list）

5. 其它创建列表的方式

• 5.1 使用List<E>.empty构造空列表
• 5.2 使用List<E>.from构造列表
• 5.3 使用List<E>.generate构造列表
• 5.4 使用List<E>.of构造列表

6. 常用属性

7. 常用方法

8. 列表的遍历

• 8.1 使用 for 语句遍历列表
• 8.2 使用 for…in 语句遍历列表
• 8.3 使用 List.forEach 方法遍历列表

1. 概述

List是一种序列，即元素的有序集合。List中的数据可以重复，索引从0开始递增，且索引和值之间是一一对应的关系，这和其它语言类似。
在Dart语言中，列表（List）分为 定长列表 、 可增长列表和不可变列表。前者长度是固定的，也就是说一旦定义当你尝试使用可以更改列表长度的操作时，将发生错误。最后一个所谓不可变列表指的该列表一经创建不再能够改变。

2. 定长列表（Fixed-length list）

定长列表是长度固定的列表，若尝试更改其长度则会发生错误。列表的构造函数提供了filled方法，用于创建一个给定长度的列表。
定长列表由List.filled方法创建：

List<E>.filled(
  int length,
  E fill,
  {bool growable = false}
)

例如：

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

3. 可增长列表（Growable list）

创建的默认可增长列表[]保留一个内部缓冲区，并在必要时增长该缓冲区。这保证了一系列加法操作都将在摊销的常数时间内执行。直接设置长度可能会花费与新长度成正比的时间，并且可能会改变内部容量，因此随后的添加操作将需要立即增加缓冲区容量。
例如：

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

4. 不可变列表（unmodifiable list）

使用List.unmodifiable方法可以创建不可变列表。不可变列表的列表不能改变其长度或元素。如果元素本身是不可变的，那么结果列表也是不可变的。

List<E>.unmodifiable(
    Iterable elements
)

例如：

final numbers = <int>[1, 2, 3];
final unmodifiableList = List.unmodifiable(numbers); // [1, 2, 3]
unmodifiableList[1] = 87; // Throws.

5. 其它创建列表的方式

5.1 使用List<E>.empty构造空列表

例如：

final growableList = List.empty(growable: true); // []
growableList.add(1); // [1]

final fixedLengthList = List.empty(growable: false);
fixedLengthList.add(1); // error

5.2 使用List<E>.from构造列表

格式为：

List<E>.from(
  Iterable elements,     // 从一个可迭代对象创建
  {bool growable = true} // 是否可创建为增长列表
)

例如：

final numbers = <num>[1, 2, 3];
final listFrom = List<int>.from(numbers);
print(listFrom); // [1, 2, 3]

5.3 使用List<E>.generate构造列表

格式为：

List<E>.generate(
    int length,
    E generator(
        int index
    ),
    {bool growable = true}
)

该方法创建一个具有长度位置的列表，并用调用生成器为范围0内的每个索引创建的值填充该列表…长度- 1，按升序排列。
例如：

final growableList =
    List<int>.generate(3, (int index) => index * index, growable: true);
print(growableList); // [0, 1, 4]

final fixedLengthList =
    List<int>.generate(3, (int index) => index * index, growable: false);
print(fixedLengthList); // [0, 1, 4]

5.4 使用List<E>.of构造列表

格式为：

List<E>.of(
    Iterable<E> elements,  // 从一个可迭代对象创建
    {bool growable = true} // 是否可创建为增长列表
)

例如：

final numbers = <int>[1, 2, 3];
final listOf = List<num>.of(numbers);
print(listOf); // [1, 2, 3]

6. 常用属性

例子：

void main() {
  List a = [];
  List b = [1, 2, 3, 4, 5];

  print('列表 a 的长度为 ${a.length}');
  print('列表 b 的长度为 ${b.length}');

  print('列表 a 是否为空： ${a.isEmpty}');
  print('列表 b 是否非空： ${b.isNotEmpty}');

  print('列表 b 反序： ${b.reversed}');
  print('列表 b ： ${b}');
}

其运行结果为：

列表 a 的长度为 0
列表 b 的长度为 5
列表 a 是否为空： true
列表 b 是否非空： true
列表 b 反序： (5, 4, 3, 2, 1)
列表 b ： [1, 2, 3, 4, 5]

7. 常用方法

【例】：

void main() {
  List a = [0, 1, 2, 3, 4, 5];

  a.add(6); // 尾部插入一个元素 6
  print(a);

  print('a.indexOf(3) = ${a.indexOf(3)}');
  print('a.indexOf(9) = ${a.indexOf(9)}');

  a.remove(0); // 移除索引为 0 处的元素
  print(a);

  a.insert(5, 6); // 在索引为 5 元素后插入元素6
  print(a);

  // 在索引为 7 元素后插入一个列表中的所有元素
  a.insertAll(7, [1, 2, 3, 4, 5]);
  print(a);
}

输出为：

[0, 1, 2, 3, 4, 5, 6]
a.indexOf(3) = 3
a.indexOf(9) = -1
[1, 2, 3, 4, 5, 6]
[1, 2, 3, 4, 5, 6, 6]
[1, 2, 3, 4, 5, 6, 6, 1, 2, 3, 4, 5]

【例】：fillRange

final words = List.filled(5, 'old');
print(words); // [old, old, old, old, old]
words.fillRange(1, 3, 'new');
print(words); // [old, new, new, old, old]

【例】：fillRange

final words = List.filled(5, 'old');
print(words); // [old, old, old, old, old]
words.fillRange(1, 3, 'new');
print(words); // [old, new, new, old, old]

【例】：sort

final a = <String>['two', 'three', 'four'];
// Sort from shortest to longest.
a.sort((a, b) => a.length.compareTo(b.length));
print(a); // [two, four, three]


final b = <int>[13, 2, -11, 0];
b.sort();
print(b); // [-11, 0, 2, 13]

【例】：getRange与sublist

// getRange
final colors = <String>['red', 'green', 'blue', 'orange', 'pink'];
final firstRange = colors.getRange(0, 3);
print(firstRange.join(', ')); // red, green, blue

final secondRange = colors.getRange(2, 5);
print(secondRange.join(', ')); // blue, orange, pink

// sublist
final colors = <String>['red', 'green', 'blue', 'orange', 'pink'];
print(colors.sublist(1, 3)); // [green, blue]

final colors = <String>['red', 'green', 'blue', 'orange', 'pink'];
print(colors.sublist(3)); // [orange, pink]

【例】：map

var products = jsonDecode('''
[
  {"name": "Screwdriver", "price": 42.00},
  {"name": "Wingnut", "price": 0.50}
]
''');
var values = products.map((product) => product['price'] as double);
var totalPrice = values.fold(0.0, (a, b) => a + b); // 42.5.

8. 列表的遍历

8.1 使用 for 语句遍历列表

void main() {
  List a = [1, 2, 3, 4, 5];
  for (var i = 0; i < a.length; i++) {
    print(a[i]);
  }
}

8.2 使用 for…in 语句遍历列表

void main() {
  List a = [1, 2, 3, 4, 5];
  // for in 语句
  for (var i in a) {
    print(i);
  }
}

8.3 使用 List.forEach 方法遍历列表

void main() {
  List a = [1, 2, 3, 4, 5];
  // List 的 forEach 方法
  a.forEach((elem) {
    print(elem);
  });
}

或者也可以写成 箭头函数的形式 ：

void main() {
  List a = [1, 2, 3, 4, 5];
  a.forEach((elem) => {print(elem)});
}

其中箭头函数是一种简写模式，与JavaScript/TypeScript中的箭头函数不同的是，dart语言中的箭头函数目不支持果条语句。也就是说，如果你想写多条语句，则不可以使用 箭头函数的写法。由于只有一条语句，往往这对代表代码块的花括号{}也是可以省去的。