HashMap<K, V> 类 抽象 最终

基于哈希表的 Map 实现。

HashMap 是无序的（迭代顺序不保证）。

HashMap 中的键必须有一致的 Object.== 和 Object.hashCode 实现。这意味着 == 运算符必须在键上定义一个稳定的等价关系（自反性、对称性、传递性和随时间保持一致），并且对于通过 == 被视为等价的对象，hashCode 必须相同。

遍历映射的键、值或条目（通过 forEach）可能是任意顺序。迭代顺序只有在修改映射时才会改变。值是以与它们相关联的键相同的顺序迭代的，因此平行遍历 keys 和 values 将给出匹配的键和值对。

注意：在进行操作（例如在调用 forEach 或 putIfAbsent 期间调用的函数）或在迭代映射（keys、values 或 entries）时，不要修改映射（添加或删除键），可能会引发错误。

在键在映射中时，不要以任何方式修改它们，以改变它们的等价性（从而改变它们的哈希码）。如果一个映射键的 Object.hashCode 发生变化，可能会导致未来对该键的查找失败。

示例

final Map<int, String> planets = HashMap(); // Is a HashMap

要将数据添加到映射中，请使用 operator[]、addAll 或 addEntries。

planets[3] = 'Earth';
planets.addAll({4: 'Mars'});
final gasGiants = {6: 'Jupiter', 5: 'Saturn'};
planets.addEntries(gasGiants.entries);
print(planets); // fx {5: Saturn, 6: Jupiter, 3: Earth, 4: Mars}

要检查映射是否为空，请使用 isEmpty 或 isNotEmpty。要查找映射条目的数量，请使用 length。

final isEmpty = planets.isEmpty; // false
final length = planets.length; // 4

forEach 遍历映射的所有条目。

planets.forEach((key, value) {
  print('$key \t $value');
  // 5        Saturn
  // 4        Mars
  // 3        Earth
  // 6        Jupiter
});

要检查映射是否具有特定键的条目，请使用 containsKey。

final keyOneExists = planets.containsKey(4); // true
final keyFiveExists = planets.containsKey(1); // false

要检查映射是否具有特定值的条目，请使用 containsValue。

final marsExists = planets.containsValue('Mars'); // true
final venusExists = planets.containsValue('Venus'); // false

要删除具有特定键的条目，请使用 remove。

final removeValue = planets.remove(5);
print(removeValue); // Jupiter
print(planets); // fx {4: Mars, 3: Earth, 5: Saturn}

要根据它们的键和值同时删除多个条目，请使用 removeWhere。

planets.removeWhere((key, value) => key == 5);
print(planets); // fx {3: Earth, 4: Mars}

根据是否已存在具有该键的条目，有条件地添加或修改特定键的值，请使用 putIfAbsent 或 update。

planets.update(4, (v) => 'Saturn');
planets.update(8, (v) => '', ifAbsent: () => 'Neptune');
planets.putIfAbsent(4, () => 'Another Saturn');
print(planets); // fx {4: Saturn, 8: Neptune, 3: Earth}

根据现有的键和值更新所有键的值，请使用 updateAll。

planets.updateAll((key, value) => 'X');
print(planets); // fx {8: X, 3: X, 4: X}

要删除所有条目并清空映射，请使用 clear。

planets.clear();
print(planets); // {}
print(planets.isEmpty); // true

另请参阅

• Map，键/值对集合的通用接口。
• LinkedHashMap 按键插入顺序迭代。
• SplayTreeMap 按排序顺序迭代键。