map

Map

通常来说， Map 是用来关联 keys 和 values 的对象。 keys 和 values 可以是任何类型的对象。一个key只能在一个 Map 对象中出现一次。 但是 value 却能出现多次。 Dart 中 Map 通过 Map 字面量 和 Map 类型来实现。

以下是使用 Map 字面量简单的两个例子：

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

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

提示： Dart 会将 gifts 的类型推断为 Map（String, String）， nobleGases 的类型推断为 Map（int, String ）。 若在上面的 map 中添加错误类型，那么分析器或者运行时就会引发错误。

上面的 Map 对象也能用 Map 构造函数创建：

var gifts = Map();
gifts['first'] = 'partridge';
gifts['second'] = 'turtledoves';
gifts['fifth'] = 'golden rings';

var nobleGases = Map();
nobleGases[2] = 'helium';
nobleGases[10] = 'neon';
nobleGases[18] = 'argon';

提示: 因为new 关键字在 Dart 2 中是可选的，所以只有 Map() ，没有 new Map()。 。

与JS相似，已有的 Map 中添加 key-value 对：

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

与JS相似的，从一个 Map 中获取一个 value：

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

key，Map 返回 null 则Map 中不包含所要查找的：

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

获取当前 Map 中的 key-value 对数量使用 .length 函数：

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

创建 Map 类型运行时常量，要加上关键字 const 在Map 字面量前。

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

// constantMap[2] = 'Helium'; // 取消注释会引起错误。