dart:collection
LinkedHashMap<K, V> class
A hash-table based implementation of Map.
The insertion order of keys is remembered, and keys are iterated in the order they were inserted into the map. Values are iterated in their corresponding key's order. Changing a key's value, when the key is already in the map, does not change the iteration order, but removing the key and adding it again will make it be last in the iteration order.
The keys of a LinkedHashMap
must have consistent Object.== and Object.hashCode implementations. This means that the ==
operator must define a stable equivalence relation on the keys (reflexive, symmetric, transitive, and consistent over time), and that hashCode
must be the same for objects that are considered equal by ==
.
The map allows null
as a key.
- Implements
-
Constructors
- LinkedHashMap({bool equals(K key1, K key2), int hashCode(K key), bool isValidKey(dynamic potentialKey) })
factory
- Creates an insertion-ordered hash-table based Map. [...]
- LinkedHashMap.from(Map other)
factory
- Creates a LinkedHashMap that contains all key value pairs of
other
. [...] - LinkedHashMap.fromIterable(Iterable iterable, { K key(dynamic element), V value(dynamic element) })
factory
- Creates a LinkedHashMap where the keys and values are computed from the
iterable
. [...] - LinkedHashMap.fromIterables(Iterable<K> keys, Iterable<V> values)
factory
- Creates a LinkedHashMap associating the given
keys
to values
. [...] - LinkedHashMap.identity()
factory
- Creates an insertion-ordered identity-based map. [...]
- LinkedHashMap.of(Map<K, V> other)
factory
- Creates a LinkedHashMap that contains all key value pairs of
other
.
Properties
- entries → Iterable<MapEntry<K, V>>
read-only, inherited
- The map entries of this.
- hashCode → int
read-only, inherited
- The hash code for this object. [...]
- isEmpty → bool
read-only, inherited
- Returns true if there is no key/value pair in the map.
- isNotEmpty → bool
read-only, inherited
- Returns true if there is at least one key/value pair in the map.
- keys → Iterable<K>
read-only, inherited
- The keys of this. [...]
- length → int
read-only, inherited
- The number of key/value pairs in the map.
- runtimeType → Type
read-only, inherited
- A representation of the runtime type of the object.
- values → Iterable<V>
read-only, inherited
- The values of this. [...]
Methods
- addAll(Map<K, V> other) → void
inherited
- Adds all key/value pairs of
other
to this map. [...] - addEntries(Iterable<MapEntry<K, V>> newEntries) → void
inherited
- Adds all key/value pairs of
newEntries
to this map. [...] - cast<RK, RV>() → Map<RK, RV>
inherited
- Provides a view of this map as having
RK
keys and RV
instances, if necessary. [...] - clear() → void
inherited
- Removes all pairs from the map. [...]
- containsKey(Object key) → bool
inherited
- Returns true if this map contains the given
key
. [...] - containsValue(Object value) → bool
inherited
- Returns true if this map contains the given
value
. [...] - forEach(void f(K key, V value)) → void
inherited
- Applies
f
to each key/value pair of the map. [...] - map<K2, V2>(MapEntry<K2, V2> f(K key, V value)) → Map<K2, V2>
inherited
- Returns a new map where all entries of this map are transformed by the given
f
function. - noSuchMethod(Invocation invocation) → dynamic
inherited
- Invoked when a non-existent method or property is accessed. [...]
- putIfAbsent(K key, V ifAbsent()) → V
inherited
- Look up the value of
key
, or add a new value if it isn't there. [...] - remove(Object key) → V
inherited
- Removes
key
and its associated value, if present, from the map. [...] - removeWhere(bool predicate(K key, V value)) → void
inherited
- Removes all entries of this map that satisfy the given
predicate
. - toString() → String
inherited
- Returns a string representation of this object.
- update(K key, V update(V value), { V ifAbsent() }) → V
inherited
- Updates the value for the provided
key
. [...] - updateAll(V update(K key, V value)) → void
inherited
- Updates all values. [...]
Operators
- operator ==(dynamic other) → bool
inherited
- The equality operator. [...]
- operator [](Object key) → V
inherited
- Returns the value for the given
key
or null if key
is not in the map. [...] - operator []=(K key, V value) → void
inherited
- Associates the
key
with the given value
. [...]