dart:core

Map абстрактный класс

Коллекция пар ключ-значение, из которой можно извлечь значение по соответствующему ключу.

В отображении конечное число ключей, и каждому ключу соответствует ровно одно значение.

Отображения, а также их ключи и значения, могут быть итерированы. Порядок итерации определяется типом отображения. Примеры:

• Простой HashMap неупорядочен (никакой порядок не гарантируется),
• LinkedHashMap итерируется в порядке добавления ключей,
• а такое отсортированное отображение, как SplayTreeMap, итерирует ключи в отсортированном порядке.

В общем случае не допускается изменение отображения (добавление или удаление ключей) во время выполнения операции над отображением, например, в функциях, вызываемых во время выполнения forEach или putIfAbsent. Изменение отображения во время итерации ключей или значений может также нарушить итерацию.

Реализовано в

• HashMap
• HttpSession
• MapMixin
• MapView
• SplayTreeMap
• Storage

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

Map()

factory

Создает экземпляр Map с реализацией по умолчанию, LinkedHashMap.

Map.from(Map other)

factory

Создает экземпляр LinkedHashMap, который содержит все пары ключ-значение other.

Map.fromIterable(Iterable iterable, { K key(element), V value(element) })

factory

Создает экземпляр Map, в котором ключи и значения вычисляются из iterable.

Map.fromIterables(Iterable<K> keys, Iterable<V> values)

factory

Создает экземпляр Map, сопоставляющий заданные keys с values.

Map.identity()

factory

Создает отображение тождества с реализацией по умолчанию, LinkedHashMap.

Map.unmodifiable(Map other)

factory

Создает неизменяемое отображение по умолчанию, содержащее записи other.

Свойства

isEmpty → bool

только для чтения

Возвращает true, если в отображении нет пар ключ-значение.

isNotEmpty → bool

только для чтения

Возвращает true, если в отображении есть хотя бы одна пара ключ-значение.

keys → Iterable<K>

только для чтения

Ключи this.

length → int

только для чтения

Количество пар ключ-значение в отображении.

values → Iterable<V>

только для чтения

Значения this.

hashCode → int

только для чтения, унаследованное

Хеш-код этого объекта.

runtimeType → Type

только для чтения, унаследованное

Представление типа времени выполнения объекта.

Операторы

operator [](Object key) → V

Возвращает значение для данного key или null, если key нет в отображении.

operator []=(K key, V value) → void

Связывает key с заданным value.

operator ==(other) → bool

унаследованное

Оператор равенства.

Методы

addAll(Map<K, V> other) → void

Добавляет все пары ключ-значение из other в это отображение.

clear() → void

Удаляет все пары из отображения.

containsKey(Object key) → bool

Возвращает true, если это отображение содержит данный key.

containsValue(Object value) → bool

Возвращает true, если это отображение содержит данное value.

forEach(void f(K key, V value)) → void

Применяет f к каждой паре ключ-значение в отображении.

putIfAbsent(K key, V ifAbsent()) → V

Ищет значение key, или добавляет новое значение, если его нет.

remove(Object key) → V

Удаляет key и его связанное значение, если они присутствуют, из отображения.

noSuchMethod(Invocation invocation) → dynamic

унаследованное

Вызывается при обращении к несуществующему методу или свойству.

toString() → String

унаследованное

Возвращает строковое представление этого объекта.