跳到主要内容
目录

集合

目录

Dart 内置支持列表 (List)、集合 (Set) 和映射 (Map) 集合。要了解有关配置集合包含的类型的更多信息，请查看泛型。

列表

#

几乎每种编程语言中最常见的集合可能是数组，或对象的有序组。在 Dart 中，数组是 List 对象，因此大多数人直接称它们为列表。

Dart 列表字面量用逗号分隔的表达式或值列表表示，并用方括号 ([]) 括起来。这是一个简单的 Dart 列表

dart
var list = [1, 2, 3];

您可以在 Dart 集合字面量中的最后一项之后添加逗号。这个尾随逗号不会影响集合，但可以帮助防止复制粘贴错误。

dart
var list = ['Car', 'Boat', 'Plane'];

列表使用基于零的索引，其中 0 是第一个值的索引，而 list.length - 1 是最后一个值的索引。您可以使用 .length 属性获取列表的长度，并使用下标运算符 ([]) 访问列表的值

dart
var list = [1, 2, 3];
assert(list.length == 3);
assert(list[1] == 2);

list[1] = 1;
assert(list[1] == 1);

要创建编译时常量的列表，请在列表字面量之前添加 const

dart
var constantList = const [1, 2, 3];
// constantList[1] = 1; // This line will cause an error.

有关列表的更多信息，请参阅 dart:core 文档的 Lists 部分。

集合 (Set)

#

Dart 中的集合 (Set) 是唯一项的无序集合。Dart 对集合 (Set) 的支持由集合字面量和 Set 类型提供。

这是一个简单的 Dart 集合 (Set)，使用集合字面量创建

dart
var halogens = {'fluorine', 'chlorine', 'bromine', 'iodine', 'astatine'};

要创建空集合 (Set)，请使用前面带有类型参数的 {}，或将 {} 赋值给 Set 类型的变量

dart
var names = <String>{};
// Set<String> names = {}; // This works, too.
// var names = {}; // Creates a map, not a set.

使用 add() 或 addAll() 方法向现有集合 (Set) 添加项

dart
var elements = <String>{};
elements.add('fluorine');
elements.addAll(halogens);

使用 .length 获取集合 (Set) 中项的数量

dart
var elements = <String>{};
elements.add('fluorine');
elements.addAll(halogens);
assert(elements.length == 5);

要创建编译时常量的集合 (Set)，请在集合字面量之前添加 const

dart
final constantSet = const {
  'fluorine',
  'chlorine',
  'bromine',
  'iodine',
  'astatine',
};
// constantSet.add('helium'); // This line will cause an error.

有关集合 (Set) 的更多信息，请参阅 dart:core 文档的 Sets 部分。

映射 (Map)

#

一般来说，映射 (Map) 是一个关联键和值的对象。键和值都可以是任何类型的对象。每个键只出现一次，但您可以多次使用相同的值。Dart 对映射 (Map) 的支持由映射字面量和 Map 类型提供。

这里有一些简单的 Dart 映射 (Map)，使用映射字面量创建

dart
var gifts = {
  // Key:    Value
  'first': 'partridge',
  'second': 'turtledoves',
  'fifth': 'golden rings',
};

var nobleGases = {2: 'helium', 10: 'neon', 18: 'argon'};

您可以使用 Map 构造函数创建相同的对象

dart
var gifts = Map<String, String>();
gifts['first'] = 'partridge';
gifts['second'] = 'turtledoves';
gifts['fifth'] = 'golden rings';

var nobleGases = Map<int, String>();
nobleGases[2] = 'helium';
nobleGases[10] = 'neon';
nobleGases[18] = 'argon';

使用下标赋值运算符 ([]=) 向现有映射 (Map) 添加新的键值对

dart
var gifts = {'first': 'partridge'};
gifts['fourth'] = 'calling birds'; // Add a key-value pair

使用下标运算符 ([]) 从映射 (Map) 中检索值

dart
var gifts = {'first': 'partridge'};
assert(gifts['first'] == 'partridge');

如果您查找映射 (Map) 中不存在的键，则会返回 null

dart
var gifts = {'first': 'partridge'};
assert(gifts['fifth'] == null);

使用 .length 获取映射 (Map) 中键值对的数量

dart
var gifts = {'first': 'partridge'};
gifts['fourth'] = 'calling birds';
assert(gifts.length == 2);

要创建编译时常量的映射 (Map)，请在映射字面量之前添加 const

dart
final constantMap = const {2: 'helium', 10: 'neon', 18: 'argon'};

// constantMap[2] = 'Helium'; // This line will cause an error.

有关映射 (Map) 的更多信息，请参阅 dart:core 文档的 Maps 部分。

运算符

#

扩展运算符

#

Dart 在列表 (List)、映射 (Map) 和集合 (Set) 字面量中支持扩展运算符 (...) 和空感知扩展运算符 (...?)。扩展运算符提供了一种简洁的方式将多个值插入到集合中。

例如，您可以使用扩展运算符 (...) 将一个列表的所有值插入到另一个列表中

dart
var list = [1, 2, 3];
var list2 = [0, ...list];
assert(list2.length == 4);

如果扩展运算符右侧的表达式可能为 null，您可以使用空感知扩展运算符 (...?) 来避免异常

dart
var list2 = [0, ...?list];
assert(list2.length == 1);

有关使用扩展运算符的更多详细信息和示例，请参阅扩展运算符提案。

控制流运算符

#

Dart 提供了 collection if 和 collection for，用于列表 (List)、映射 (Map) 和集合 (Set) 字面量。您可以使用这些运算符，使用条件 (if) 和重复 (for) 来构建集合。

这是一个使用 collection if 创建包含三个或四个项的列表的示例

dart
var nav = ['Home', 'Furniture', 'Plants', if (promoActive) 'Outlet'];

Dart 还支持 collection 字面量中的 if-case

dart
var nav = ['Home', 'Furniture', 'Plants', if (login case 'Manager') 'Inventory'];

这是一个使用 collection for 在将列表中的项添加到另一个列表之前对其进行操作的示例

dart
var listOfInts = [1, 2, 3];
var listOfStrings = ['#0', for (var i in listOfInts) '#$i'];
assert(listOfStrings[1] == '#1');

有关使用 collection if 和 for 的更多详细信息和示例，请参阅控制流集合提案。

除非另有说明，否则本网站上的文档反映了 Dart 3.7.1 版本。页面最后更新于 2025-02-12。 查看源代码 或 报告问题。