Класс HashMap<K, V>

Реализация Map на основе хеш-таблицы.

Класс HashMap не гарантирует порядок итерации.

Ключи в HashMap должны иметь согласованную реализацию Object.== и Object.hashCode. Это означает, что оператор == должен определять стабильное отношение эквивалентности на ключах (рефлексивное, симметричное, транзитивное и согласованное со временем), и что hashCode должно быть одинаковым для объектов, считающихся равными согласно ==.

Итерация по ключам, значениям или парам (через forEach) может происходить в любом порядке. Порядок итерации изменяется только при модификации карты. Значения итерируются в том же порядке, что и их ассоциированные ключи, поэтому одновременная итерация по keys и values даст соответствующие пары ключ-значение.

Обратите внимание: Не изменяйте карту (добавляйте или удаляйте ключи) во время выполнения операции на карте, например, в функциях, вызываемых во время forEach или putIfAbsent, или во время итерации по карте (keys, values или entries).

Пример:

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 итерируется по ключам в отсортированном порядке.

Реализованные типы

Map<K, V>

Конструкторы

HashMap({bool equals(K, K)?, int hashCode(K)?, bool isValidKey(dynamic)?}) factory: Создаёт неупорядоченную хеш-табличную карту Map.
HashMap.from(Map other) factory: Создаёт HashMap, содержащий все пары ключ/значение из other.
HashMap.fromEntries(Iterable<MapEntry<K, V>> entries) factory: Создаёт HashMap, содержащий пары элементов из entries.
HashMap.fromIterable(Iterable iterable, {K key(dynamic element)?, V value(dynamic element)?}) factory: Создаёт HashMap, где ключи и значения вычисляются из iterable.
HashMap.fromIterables(Iterable<K> keys, Iterable<V> values) factory: Создаёт HashMap, сопоставляющий заданные keys с values.
HashMap.identity() factory: Создаёт неупорядоченную карту на основе идентификации.
HashMap.of(Map<K, V> other) factory: Создаёт HashMap, содержащий все пары ключ/значение из other. Пример:

Свойства

entries → Iterable<MapEntry<K, V>> только для чтения, унаследованное: Элементы карты this.
hashCode → int только для чтения, унаследованное: Хеш-код этого объекта.
isEmpty → bool только для чтения, унаследованное: Пуста ли карта.
isNotEmpty → bool только для чтения, унаследованное: Содержит ли карта хотя бы одну пару ключ/значение.
keys → Iterable<K> только для чтения, унаследованное: Ключи this.
length → int только для чтения, унаследованное: Количество пар ключ/значение в карте.
runtimeType → Type только для чтения, унаследованное: Представление текущего типа объекта.
values → Iterable<V> только для чтения, унаследованное: Значения this.

Методы

addAll(Map<K, V> other) → void inherited: Добавляет все пары ключ/значение из other в эту карту.
addEntries(Iterable<MapEntry<K, V>> newEntries) → void inherited: Добавляет все пары ключ/значение из newEntries в эту карту.
cast<RK, RV>() → Map<RK, RV> inherited: Предоставляет представление этой карты как имеющей RK ключи и RV значения, если необходимо.
clear() → void inherited: Удаляет все элементы из карты.
containsKey(Object? key) → bool inherited: Присутствует ли в этой карте данный key.
containsValue(Object? value) → bool inherited: Содержит ли эта карта данное value.
forEach(void action(K key, V value)) → void inherited: Применяет action к каждой паре ключ/значение в карте.
map<K2, V2>(MapEntry<K2, V2> convert(K key, V value)) → Map<K2, V2> inherited: Возвращает новую карту, в которой все элементы этой карты преобразуются с помощью заданной convert функции.
noSuchMethod(Invocation invocation) → dynamic inherited: Вызывается при попытке обратиться к несуществующему методу или свойству.
putIfAbsent(K key, V ifAbsent()) → V inherited: Ищет значение key, или добавляет новую запись, если её нет.
remove(Object? key) → V? inherited: Удаляет key и связанное с ним значение, если они присутствуют, из карты.
removeWhere(bool test(K key, V value)) → void inherited: Удаляет все элементы этой карты, удовлетворяющие заданному test.
toString() → String inherited: Строковое представление этого объекта.
update(K key, V update(V value), {V ifAbsent()?}) → V inherited: Обновляет значение для указанного key.
updateAll(V update(K key, V value)) → void inherited: Обновляет все значения.

Операторы

operator ==(Object other) → bool inherited: Оператор равенства.
operator [](Object? key) → V? inherited: Значение для данного key, или null, если key отсутствует в карте.
operator []=(K key, V value) → void inherited: Связывает key с данным value.

© 2012 the Dart project authors
Licensed under the BSD 3-Clause "New" or "Revised" License.
https://api.dart.dev/stable/2.18.5/dart-collection/HashMap-class.html