pub struct HashMap<K, V, S = RandomState> { /* private fields */ }
Expand description
An unordered map.
An immutable hash map using [hash array mapped tries] 1.
Most operations on this map are O(logx n) for a
suitably high x that it should be nearly O(1) for most maps.
Because of this, it’s a great choice for a generic map as long as
you don’t mind that keys will need to implement
Hash
and Eq
.
Map entries will have a predictable order based on the hasher
being used. Unless otherwise specified, this will be the standard
RandomState
hasher.
Implementations
sourceimpl<K, V> HashMap<K, V, RandomState>
impl<K, V> HashMap<K, V, RandomState>
sourceimpl<K, V, S> HashMap<K, V, S>
impl<K, V, S> HashMap<K, V, S>
sourcepub fn is_empty(&self) -> bool
pub fn is_empty(&self) -> bool
Test whether a hash map is empty.
Time: O(1)
Examples
assert!(
!hashmap!{1 => 2}.is_empty()
);
assert!(
HashMap::<i32, i32>::new().is_empty()
);
sourcepub fn len(&self) -> usize
pub fn len(&self) -> usize
Get the size of a hash map.
Time: O(1)
Examples
assert_eq!(3, hashmap!{
1 => 11,
2 => 22,
3 => 33
}.len());
sourcepub fn ptr_eq(&self, other: &Self) -> bool
pub fn ptr_eq(&self, other: &Self) -> bool
Test whether two maps refer to the same content in memory.
This is true if the two sides are references to the same map, or if the two maps refer to the same root node.
This would return true if you’re comparing a map to itself, or if you’re comparing a map to a fresh clone of itself.
Time: O(1)
sourcepub fn with_hasher<RS>(hasher: RS) -> Self where
Arc<S>: From<RS>,
pub fn with_hasher<RS>(hasher: RS) -> Self where
Arc<S>: From<RS>,
Construct an empty hash map using the provided hasher.
sourcepub fn hasher(&self) -> &Arc<S>
pub fn hasher(&self) -> &Arc<S>
Get a reference to the map’s BuildHasher
.
sourcepub fn new_from<K1, V1>(&self) -> HashMap<K1, V1, S> where
K1: Hash + Eq + Clone,
V1: Clone,
pub fn new_from<K1, V1>(&self) -> HashMap<K1, V1, S> where
K1: Hash + Eq + Clone,
V1: Clone,
Construct an empty hash map using the same hasher as the current hash map.
sourcepub fn iter(&self) -> Iter<'_, K, V>ⓘNotable traits for Iter<'a, K, V>impl<'a, K, V> Iterator for Iter<'a, K, V> type Item = (&'a K, &'a V);
pub fn iter(&self) -> Iter<'_, K, V>ⓘNotable traits for Iter<'a, K, V>impl<'a, K, V> Iterator for Iter<'a, K, V> type Item = (&'a K, &'a V);
Get an iterator over the key/value pairs of a hash map.
Please note that the order is consistent between maps using the same hasher, but no other ordering guarantee is offered. Items will not come out in insertion order or sort order. They will, however, come out in the same order every time for the same map.
sourcepub fn keys(&self) -> Keys<'_, K, V>ⓘNotable traits for Keys<'a, K, V>impl<'a, K, V> Iterator for Keys<'a, K, V> type Item = &'a K;
pub fn keys(&self) -> Keys<'_, K, V>ⓘNotable traits for Keys<'a, K, V>impl<'a, K, V> Iterator for Keys<'a, K, V> type Item = &'a K;
Get an iterator over a hash map’s keys.
Please note that the order is consistent between maps using the same hasher, but no other ordering guarantee is offered. Items will not come out in insertion order or sort order. They will, however, come out in the same order every time for the same map.
sourcepub fn values(&self) -> Values<'_, K, V>ⓘNotable traits for Values<'a, K, V>impl<'a, K, V> Iterator for Values<'a, K, V> type Item = &'a V;
pub fn values(&self) -> Values<'_, K, V>ⓘNotable traits for Values<'a, K, V>impl<'a, K, V> Iterator for Values<'a, K, V> type Item = &'a V;
Get an iterator over a hash map’s values.
Please note that the order is consistent between maps using the same hasher, but no other ordering guarantee is offered. Items will not come out in insertion order or sort order. They will, however, come out in the same order every time for the same map.
sourceimpl<K, V, S> HashMap<K, V, S> where
K: Hash + Eq,
S: BuildHasher,
impl<K, V, S> HashMap<K, V, S> where
K: Hash + Eq,
S: BuildHasher,
sourcepub fn get<BK>(&self, key: &BK) -> Option<&V> where
BK: Hash + Eq + ?Sized,
K: Borrow<BK>,
pub fn get<BK>(&self, key: &BK) -> Option<&V> where
BK: Hash + Eq + ?Sized,
K: Borrow<BK>,
Get the value for a key from a hash map.
Time: O(log n)
Examples
let map = hashmap!{123 => "lol"};
assert_eq!(
map.get(&123),
Some(&"lol")
);
sourcepub fn get_key_value<BK>(&self, key: &BK) -> Option<(&K, &V)> where
BK: Hash + Eq + ?Sized,
K: Borrow<BK>,
pub fn get_key_value<BK>(&self, key: &BK) -> Option<(&K, &V)> where
BK: Hash + Eq + ?Sized,
K: Borrow<BK>,
Get the key/value pair for a key from a hash map.
Time: O(log n)
Examples
let map = hashmap!{123 => "lol"};
assert_eq!(
map.get_key_value(&123),
Some((&123, &"lol"))
);
sourcepub fn contains_key<BK>(&self, k: &BK) -> bool where
BK: Hash + Eq + ?Sized,
K: Borrow<BK>,
pub fn contains_key<BK>(&self, k: &BK) -> bool where
BK: Hash + Eq + ?Sized,
K: Borrow<BK>,
Test for the presence of a key in a hash map.
Time: O(log n)
Examples
let map = hashmap!{123 => "lol"};
assert!(
map.contains_key(&123)
);
assert!(
!map.contains_key(&321)
);
sourcepub fn is_submap_by<B, RM, F>(&self, other: RM, cmp: F) -> bool where
F: FnMut(&V, &B) -> bool,
RM: Borrow<HashMap<K, B, S>>,
pub fn is_submap_by<B, RM, F>(&self, other: RM, cmp: F) -> bool where
F: FnMut(&V, &B) -> bool,
RM: Borrow<HashMap<K, B, S>>,
Test whether a map is a submap of another map, meaning that all keys in our map must also be in the other map, with the same values.
Use the provided function to decide whether values are equal.
Time: O(n log n)
sourcepub fn is_proper_submap_by<B, RM, F>(&self, other: RM, cmp: F) -> bool where
F: FnMut(&V, &B) -> bool,
RM: Borrow<HashMap<K, B, S>>,
pub fn is_proper_submap_by<B, RM, F>(&self, other: RM, cmp: F) -> bool where
F: FnMut(&V, &B) -> bool,
RM: Borrow<HashMap<K, B, S>>,
Test whether a map is a proper submap of another map, meaning that all keys in our map must also be in the other map, with the same values. To be a proper submap, ours must also contain fewer keys than the other map.
Use the provided function to decide whether values are equal.
Time: O(n log n)
sourcepub fn is_submap<RM>(&self, other: RM) -> bool where
V: PartialEq,
RM: Borrow<Self>,
pub fn is_submap<RM>(&self, other: RM) -> bool where
V: PartialEq,
RM: Borrow<Self>,
Test whether a map is a submap of another map, meaning that all keys in our map must also be in the other map, with the same values.
Time: O(n log n)
Examples
let map1 = hashmap!{1 => 1, 2 => 2};
let map2 = hashmap!{1 => 1, 2 => 2, 3 => 3};
assert!(map1.is_submap(map2));
sourcepub fn is_proper_submap<RM>(&self, other: RM) -> bool where
V: PartialEq,
RM: Borrow<Self>,
pub fn is_proper_submap<RM>(&self, other: RM) -> bool where
V: PartialEq,
RM: Borrow<Self>,
Test whether a map is a proper submap of another map, meaning that all keys in our map must also be in the other map, with the same values. To be a proper submap, ours must also contain fewer keys than the other map.
Time: O(n log n)
Examples
let map1 = hashmap!{1 => 1, 2 => 2};
let map2 = hashmap!{1 => 1, 2 => 2, 3 => 3};
assert!(map1.is_proper_submap(map2));
let map3 = hashmap!{1 => 1, 2 => 2};
let map4 = hashmap!{1 => 1, 2 => 2};
assert!(!map3.is_proper_submap(map4));
sourceimpl<K, V, S> HashMap<K, V, S> where
K: Hash + Eq + Clone,
V: Clone,
S: BuildHasher,
impl<K, V, S> HashMap<K, V, S> where
K: Hash + Eq + Clone,
V: Clone,
S: BuildHasher,
sourcepub fn iter_mut(&mut self) -> IterMut<'_, K, V>ⓘNotable traits for IterMut<'a, K, V>impl<'a, K, V> Iterator for IterMut<'a, K, V> where
K: Clone,
V: Clone, type Item = (&'a K, &'a mut V);
pub fn iter_mut(&mut self) -> IterMut<'_, K, V>ⓘNotable traits for IterMut<'a, K, V>impl<'a, K, V> Iterator for IterMut<'a, K, V> where
K: Clone,
V: Clone, type Item = (&'a K, &'a mut V);
K: Clone,
V: Clone, type Item = (&'a K, &'a mut V);
Get a mutable iterator over the values of a hash map.
Please note that the order is consistent between maps using the same hasher, but no other ordering guarantee is offered. Items will not come out in insertion order or sort order. They will, however, come out in the same order every time for the same map.
sourcepub fn get_mut<BK>(&mut self, key: &BK) -> Option<&mut V> where
BK: Hash + Eq + ?Sized,
K: Borrow<BK>,
pub fn get_mut<BK>(&mut self, key: &BK) -> Option<&mut V> where
BK: Hash + Eq + ?Sized,
K: Borrow<BK>,
Get a mutable reference to the value for a key from a hash map.
Time: O(log n)
Examples
let mut map = hashmap!{123 => "lol"};
if let Some(value) = map.get_mut(&123) {
*value = "omg";
}
assert_eq!(
map.get(&123),
Some(&"omg")
);
sourcepub fn insert(&mut self, k: K, v: V) -> Option<V>
pub fn insert(&mut self, k: K, v: V) -> Option<V>
Insert a key/value mapping into a map.
If the map already has a mapping for the given key, the previous value is overwritten.
Time: O(log n)
Examples
let mut map = hashmap!{};
map.insert(123, "123");
map.insert(456, "456");
assert_eq!(
map,
hashmap!{123 => "123", 456 => "456"}
);
sourcepub fn remove<BK>(&mut self, k: &BK) -> Option<V> where
BK: Hash + Eq + ?Sized,
K: Borrow<BK>,
pub fn remove<BK>(&mut self, k: &BK) -> Option<V> where
BK: Hash + Eq + ?Sized,
K: Borrow<BK>,
Remove a key/value pair from a map, if it exists, and return the removed value.
This is a copy-on-write operation, so that the parts of the set’s structure which are shared with other sets will be safely copied before mutating.
Time: O(log n)
Examples
let mut map = hashmap!{123 => "123", 456 => "456"};
assert_eq!(Some("123"), map.remove(&123));
assert_eq!(Some("456"), map.remove(&456));
assert_eq!(None, map.remove(&789));
assert!(map.is_empty());
sourcepub fn remove_with_key<BK>(&mut self, k: &BK) -> Option<(K, V)> where
BK: Hash + Eq + ?Sized,
K: Borrow<BK>,
pub fn remove_with_key<BK>(&mut self, k: &BK) -> Option<(K, V)> where
BK: Hash + Eq + ?Sized,
K: Borrow<BK>,
Remove a key/value pair from a map, if it exists, and return the removed key and value.
Time: O(log n)
Examples
let mut map = hashmap!{123 => "123", 456 => "456"};
assert_eq!(Some((123, "123")), map.remove_with_key(&123));
assert_eq!(Some((456, "456")), map.remove_with_key(&456));
assert_eq!(None, map.remove_with_key(&789));
assert!(map.is_empty());
sourcepub fn entry(&mut self, key: K) -> Entry<'_, K, V, S>
pub fn entry(&mut self, key: K) -> Entry<'_, K, V, S>
Get the Entry
for a key in the map for in-place manipulation.
Time: O(log n)
sourcepub fn update(&self, k: K, v: V) -> Self
pub fn update(&self, k: K, v: V) -> Self
Construct a new hash map by inserting a key/value mapping into a map.
If the map already has a mapping for the given key, the previous value is overwritten.
Time: O(log n)
Examples
let map = hashmap!{};
assert_eq!(
map.update(123, "123"),
hashmap!{123 => "123"}
);
sourcepub fn update_with<F>(&self, k: K, v: V, f: F) -> Self where
F: FnOnce(V, V) -> V,
pub fn update_with<F>(&self, k: K, v: V, f: F) -> Self where
F: FnOnce(V, V) -> V,
Construct a new hash map by inserting a key/value mapping into a map.
If the map already has a mapping for the given key, we call the provided function with the old value and the new value, and insert the result as the new value.
Time: O(log n)
sourcepub fn update_with_key<F>(&self, k: K, v: V, f: F) -> Self where
F: FnOnce(&K, V, V) -> V,
pub fn update_with_key<F>(&self, k: K, v: V, f: F) -> Self where
F: FnOnce(&K, V, V) -> V,
Construct a new map by inserting a key/value mapping into a map.
If the map already has a mapping for the given key, we call the provided function with the key, the old value and the new value, and insert the result as the new value.
Time: O(log n)
sourcepub fn update_lookup_with_key<F>(&self, k: K, v: V, f: F) -> (Option<V>, Self) where
F: FnOnce(&K, &V, V) -> V,
pub fn update_lookup_with_key<F>(&self, k: K, v: V, f: F) -> (Option<V>, Self) where
F: FnOnce(&K, &V, V) -> V,
Construct a new map by inserting a key/value mapping into a map, returning the old value for the key as well as the new map.
If the map already has a mapping for the given key, we call the provided function with the key, the old value and the new value, and insert the result as the new value.
Time: O(log n)
sourcepub fn alter<F>(&self, f: F, k: K) -> Self where
F: FnOnce(Option<V>) -> Option<V>,
pub fn alter<F>(&self, f: F, k: K) -> Self where
F: FnOnce(Option<V>) -> Option<V>,
Update the value for a given key by calling a function with the current value and overwriting it with the function’s return value.
The function gets an Option<V>
and
returns the same, so that it can decide to delete a mapping
instead of updating the value, and decide what to do if the
key isn’t in the map.
Time: O(log n)
sourcepub fn without<BK>(&self, k: &BK) -> Self where
BK: Hash + Eq + ?Sized,
K: Borrow<BK>,
pub fn without<BK>(&self, k: &BK) -> Self where
BK: Hash + Eq + ?Sized,
K: Borrow<BK>,
Construct a new map without the given key.
Construct a map that’s a copy of the current map, absent the
mapping for key
if it’s present.
Time: O(log n)
sourcepub fn retain<F>(&mut self, f: F) where
F: FnMut(&K, &V) -> bool,
pub fn retain<F>(&mut self, f: F) where
F: FnMut(&K, &V) -> bool,
Filter out values from a map which don’t satisfy a predicate.
This is slightly more efficient than filtering using an iterator, in that it doesn’t need to rehash the retained values, but it still needs to reconstruct the entire tree structure of the map.
Time: O(n log n)
Examples
let mut map = hashmap!{1 => 1, 2 => 2, 3 => 3};
map.retain(|k, v| *k > 1);
let expected = hashmap!{2 => 2, 3 => 3};
assert_eq!(expected, map);
sourcepub fn extract<BK>(&self, k: &BK) -> Option<(V, Self)> where
BK: Hash + Eq + ?Sized,
K: Borrow<BK>,
pub fn extract<BK>(&self, k: &BK) -> Option<(V, Self)> where
BK: Hash + Eq + ?Sized,
K: Borrow<BK>,
Remove a key/value pair from a map, if it exists, and return the removed value as well as the updated map.
Time: O(log n)
sourcepub fn extract_with_key<BK>(&self, k: &BK) -> Option<(K, V, Self)> where
BK: Hash + Eq + ?Sized,
K: Borrow<BK>,
pub fn extract_with_key<BK>(&self, k: &BK) -> Option<(K, V, Self)> where
BK: Hash + Eq + ?Sized,
K: Borrow<BK>,
Remove a key/value pair from a map, if it exists, and return the removed key and value as well as the updated list.
Time: O(log n)
sourcepub fn union(self, other: Self) -> Self
pub fn union(self, other: Self) -> Self
Construct the union of two maps, keeping the values in the current map when keys exist in both maps.
Time: O(n log n)
Examples
let map1 = hashmap!{1 => 1, 3 => 3};
let map2 = hashmap!{2 => 2, 3 => 4};
let expected = hashmap!{1 => 1, 2 => 2, 3 => 3};
assert_eq!(expected, map1.union(map2));
sourcepub fn union_with<F>(self, other: Self, f: F) -> Self where
F: FnMut(V, V) -> V,
pub fn union_with<F>(self, other: Self, f: F) -> Self where
F: FnMut(V, V) -> V,
Construct the union of two maps, using a function to decide what to do with the value when a key is in both maps.
The function is called when a value exists in both maps, and receives the value from the current map as its first argument, and the value from the other map as the second. It should return the value to be inserted in the resulting map.
Time: O(n log n)
sourcepub fn union_with_key<F>(self, other: Self, f: F) -> Self where
F: FnMut(&K, V, V) -> V,
pub fn union_with_key<F>(self, other: Self, f: F) -> Self where
F: FnMut(&K, V, V) -> V,
Construct the union of two maps, using a function to decide what to do with the value when a key is in both maps.
The function is called when a value exists in both maps, and receives a reference to the key as its first argument, the value from the current map as the second argument, and the value from the other map as the third argument. It should return the value to be inserted in the resulting map.
Time: O(n log n)
Examples
let map1 = hashmap!{1 => 1, 3 => 4};
let map2 = hashmap!{2 => 2, 3 => 5};
let expected = hashmap!{1 => 1, 2 => 2, 3 => 9};
assert_eq!(expected, map1.union_with_key(
map2,
|key, left, right| left + right
));
sourcepub fn unions<I>(i: I) -> Self where
S: Default,
I: IntoIterator<Item = Self>,
pub fn unions<I>(i: I) -> Self where
S: Default,
I: IntoIterator<Item = Self>,
Construct the union of a sequence of maps, selecting the value of the leftmost when a key appears in more than one map.
Time: O(n log n)
Examples
let map1 = hashmap!{1 => 1, 3 => 3};
let map2 = hashmap!{2 => 2};
let expected = hashmap!{1 => 1, 2 => 2, 3 => 3};
assert_eq!(expected, HashMap::unions(vec![map1, map2]));
sourcepub fn unions_with<I, F>(i: I, f: F) -> Self where
S: Default,
I: IntoIterator<Item = Self>,
F: Fn(V, V) -> V,
pub fn unions_with<I, F>(i: I, f: F) -> Self where
S: Default,
I: IntoIterator<Item = Self>,
F: Fn(V, V) -> V,
Construct the union of a sequence of maps, using a function to decide what to do with the value when a key is in more than one map.
The function is called when a value exists in multiple maps, and receives the value from the current map as its first argument, and the value from the next map as the second. It should return the value to be inserted in the resulting map.
Time: O(n log n)
sourcepub fn unions_with_key<I, F>(i: I, f: F) -> Self where
S: Default,
I: IntoIterator<Item = Self>,
F: Fn(&K, V, V) -> V,
pub fn unions_with_key<I, F>(i: I, f: F) -> Self where
S: Default,
I: IntoIterator<Item = Self>,
F: Fn(&K, V, V) -> V,
Construct the union of a sequence of maps, using a function to decide what to do with the value when a key is in more than one map.
The function is called when a value exists in multiple maps, and receives a reference to the key as its first argument, the value from the current map as the second argument, and the value from the next map as the third argument. It should return the value to be inserted in the resulting map.
Time: O(n log n)
sourcepub fn difference(self, other: Self) -> Self
pub fn difference(self, other: Self) -> Self
Construct the symmetric difference between two maps by discarding keys which occur in both maps.
This is an alias for the
symmetric_difference
method.
Time: O(n log n)
Examples
let map1 = hashmap!{1 => 1, 3 => 4};
let map2 = hashmap!{2 => 2, 3 => 5};
let expected = hashmap!{1 => 1, 2 => 2};
assert_eq!(expected, map1.difference(map2));
sourcepub fn symmetric_difference(self, other: Self) -> Self
pub fn symmetric_difference(self, other: Self) -> Self
Construct the symmetric difference between two maps by discarding keys which occur in both maps.
Time: O(n log n)
Examples
let map1 = hashmap!{1 => 1, 3 => 4};
let map2 = hashmap!{2 => 2, 3 => 5};
let expected = hashmap!{1 => 1, 2 => 2};
assert_eq!(expected, map1.symmetric_difference(map2));
sourcepub fn difference_with<F>(self, other: Self, f: F) -> Self where
F: FnMut(V, V) -> Option<V>,
pub fn difference_with<F>(self, other: Self, f: F) -> Self where
F: FnMut(V, V) -> Option<V>,
Construct the symmetric difference between two maps by using a function to decide what to do if a key occurs in both.
This is an alias for the
symmetric_difference_with
method.
Time: O(n log n)
sourcepub fn symmetric_difference_with<F>(self, other: Self, f: F) -> Self where
F: FnMut(V, V) -> Option<V>,
pub fn symmetric_difference_with<F>(self, other: Self, f: F) -> Self where
F: FnMut(V, V) -> Option<V>,
Construct the symmetric difference between two maps by using a function to decide what to do if a key occurs in both.
Time: O(n log n)
sourcepub fn difference_with_key<F>(self, other: Self, f: F) -> Self where
F: FnMut(&K, V, V) -> Option<V>,
pub fn difference_with_key<F>(self, other: Self, f: F) -> Self where
F: FnMut(&K, V, V) -> Option<V>,
Construct the symmetric difference between two maps by using a function to decide what to do if a key occurs in both. The function receives the key as well as both values.
This is an alias for the
symmetric_difference_with
_key
method.
Time: O(n log n)
Examples
let map1 = hashmap!{1 => 1, 3 => 4};
let map2 = hashmap!{2 => 2, 3 => 5};
let expected = hashmap!{1 => 1, 2 => 2, 3 => 9};
assert_eq!(expected, map1.difference_with_key(
map2,
|key, left, right| Some(left + right)
));
sourcepub fn symmetric_difference_with_key<F>(self, other: Self, f: F) -> Self where
F: FnMut(&K, V, V) -> Option<V>,
pub fn symmetric_difference_with_key<F>(self, other: Self, f: F) -> Self where
F: FnMut(&K, V, V) -> Option<V>,
Construct the symmetric difference between two maps by using a function to decide what to do if a key occurs in both. The function receives the key as well as both values.
Time: O(n log n)
Examples
let map1 = hashmap!{1 => 1, 3 => 4};
let map2 = hashmap!{2 => 2, 3 => 5};
let expected = hashmap!{1 => 1, 2 => 2, 3 => 9};
assert_eq!(expected, map1.symmetric_difference_with_key(
map2,
|key, left, right| Some(left + right)
));
sourcepub fn relative_complement(self, other: Self) -> Self
pub fn relative_complement(self, other: Self) -> Self
Construct the relative complement between two maps by discarding keys
which occur in other
.
Time: O(m log n) where m is the size of the other map
Examples
let map1 = ordmap!{1 => 1, 3 => 4};
let map2 = ordmap!{2 => 2, 3 => 5};
let expected = ordmap!{1 => 1};
assert_eq!(expected, map1.relative_complement(map2));
sourcepub fn intersection(self, other: Self) -> Self
pub fn intersection(self, other: Self) -> Self
Construct the intersection of two maps, keeping the values from the current map.
Time: O(n log n)
Examples
let map1 = hashmap!{1 => 1, 2 => 2};
let map2 = hashmap!{2 => 3, 3 => 4};
let expected = hashmap!{2 => 2};
assert_eq!(expected, map1.intersection(map2));
sourcepub fn intersection_with<B, C, F>(
self,
other: HashMap<K, B, S>,
f: F
) -> HashMap<K, C, S> where
B: Clone,
C: Clone,
F: FnMut(V, B) -> C,
pub fn intersection_with<B, C, F>(
self,
other: HashMap<K, B, S>,
f: F
) -> HashMap<K, C, S> where
B: Clone,
C: Clone,
F: FnMut(V, B) -> C,
Construct the intersection of two maps, calling a function with both values for each key and using the result as the value for the key.
Time: O(n log n)
sourcepub fn intersection_with_key<B, C, F>(
self,
other: HashMap<K, B, S>,
f: F
) -> HashMap<K, C, S> where
B: Clone,
C: Clone,
F: FnMut(&K, V, B) -> C,
pub fn intersection_with_key<B, C, F>(
self,
other: HashMap<K, B, S>,
f: F
) -> HashMap<K, C, S> where
B: Clone,
C: Clone,
F: FnMut(&K, V, B) -> C,
Construct the intersection of two maps, calling a function with the key and both values for each key and using the result as the value for the key.
Time: O(n log n)
Examples
let map1 = hashmap!{1 => 1, 2 => 2};
let map2 = hashmap!{2 => 3, 3 => 4};
let expected = hashmap!{2 => 5};
assert_eq!(expected, map1.intersection_with_key(
map2,
|key, left, right| left + right
));
Trait Implementations
sourceimpl<'a, K, V, S> Add<&'a HashMap<K, V, S>> for &'a HashMap<K, V, S> where
K: Hash + Eq + Clone,
V: Clone,
S: BuildHasher,
impl<'a, K, V, S> Add<&'a HashMap<K, V, S>> for &'a HashMap<K, V, S> where
K: Hash + Eq + Clone,
V: Clone,
S: BuildHasher,
sourceimpl<K, V, S> Add<HashMap<K, V, S>> for HashMap<K, V, S> where
K: Hash + Eq + Clone,
V: Clone,
S: BuildHasher,
impl<K, V, S> Add<HashMap<K, V, S>> for HashMap<K, V, S> where
K: Hash + Eq + Clone,
V: Clone,
S: BuildHasher,
sourceimpl<K, V, S> Arbitrary for HashMap<K, V, S> where
K: Hash + Eq + Arbitrary + Sync,
V: Arbitrary + Sync,
S: BuildHasher + Default + Send + Sync + 'static,
impl<K, V, S> Arbitrary for HashMap<K, V, S> where
K: Hash + Eq + Arbitrary + Sync,
V: Arbitrary + Sync,
S: BuildHasher + Default + Send + Sync + 'static,
sourceimpl<'a, K, V, S> Arbitrary<'a> for HashMap<K, V, S> where
K: Arbitrary<'a> + Hash + Eq + Clone,
V: Arbitrary<'a> + Clone,
S: BuildHasher + Default + 'static,
impl<'a, K, V, S> Arbitrary<'a> for HashMap<K, V, S> where
K: Arbitrary<'a> + Hash + Eq + Clone,
V: Arbitrary<'a> + Clone,
S: BuildHasher + Default + 'static,
sourcefn arbitrary(u: &mut Unstructured<'a>) -> Result<Self>
fn arbitrary(u: &mut Unstructured<'a>) -> Result<Self>
Generate an arbitrary value of Self
from the given unstructured data. Read more
sourcefn arbitrary_take_rest(u: Unstructured<'a>) -> Result<Self>
fn arbitrary_take_rest(u: Unstructured<'a>) -> Result<Self>
Generate an arbitrary value of Self
from the entirety of the given unstructured data. Read more
sourceimpl<K, V, S> Debug for HashMap<K, V, S> where
K: Hash + Eq + Debug,
V: Debug,
S: BuildHasher,
impl<K, V, S> Debug for HashMap<K, V, S> where
K: Hash + Eq + Debug,
V: Debug,
S: BuildHasher,
sourceimpl<K, V, S> Debug for HashMap<K, V, S> where
K: Hash + Eq + Ord + Debug,
V: Debug,
S: BuildHasher,
impl<K, V, S> Debug for HashMap<K, V, S> where
K: Hash + Eq + Ord + Debug,
V: Debug,
S: BuildHasher,
sourceimpl<K, V, S> Default for HashMap<K, V, S> where
S: BuildHasher + Default,
impl<K, V, S> Default for HashMap<K, V, S> where
S: BuildHasher + Default,
sourceimpl<'de, K, V, S> Deserialize<'de> for HashMap<K, V, S> where
K: Deserialize<'de> + Hash + Eq + Clone,
V: Deserialize<'de> + Clone,
S: BuildHasher + Default,
impl<'de, K, V, S> Deserialize<'de> for HashMap<K, V, S> where
K: Deserialize<'de> + Hash + Eq + Clone,
V: Deserialize<'de> + Clone,
S: BuildHasher + Default,
sourcefn deserialize<D>(des: D) -> Result<Self, D::Error> where
D: Deserializer<'de>,
fn deserialize<D>(des: D) -> Result<Self, D::Error> where
D: Deserializer<'de>,
Deserialize this value from the given Serde deserializer. Read more
sourceimpl<K, V, S, RK, RV> Extend<(RK, RV)> for HashMap<K, V, S> where
K: Hash + Eq + Clone + From<RK>,
V: Clone + From<RV>,
S: BuildHasher,
impl<K, V, S, RK, RV> Extend<(RK, RV)> for HashMap<K, V, S> where
K: Hash + Eq + Clone + From<RK>,
V: Clone + From<RV>,
S: BuildHasher,
sourcefn extend<I>(&mut self, iter: I) where
I: IntoIterator<Item = (RK, RV)>,
fn extend<I>(&mut self, iter: I) where
I: IntoIterator<Item = (RK, RV)>,
Extends a collection with the contents of an iterator. Read more
sourcefn extend_one(&mut self, item: A)
fn extend_one(&mut self, item: A)
extend_one
)Extends a collection with exactly one element.
sourcefn extend_reserve(&mut self, additional: usize)
fn extend_reserve(&mut self, additional: usize)
extend_one
)Reserves capacity in a collection for the given number of additional elements. Read more
sourceimpl<'a, K, V, S> From<&'a [(K, V)]> for HashMap<K, V, S> where
K: Hash + Eq + Clone,
V: Clone,
S: BuildHasher + Default,
impl<'a, K, V, S> From<&'a [(K, V)]> for HashMap<K, V, S> where
K: Hash + Eq + Clone,
V: Clone,
S: BuildHasher + Default,
sourceimpl<'a, K, V, S> From<&'a BTreeMap<K, V>> for HashMap<K, V, S> where
K: Hash + Eq + Clone,
V: Clone,
S: BuildHasher + Default,
impl<'a, K, V, S> From<&'a BTreeMap<K, V>> for HashMap<K, V, S> where
K: Hash + Eq + Clone,
V: Clone,
S: BuildHasher + Default,
sourceimpl<'a, K, V, S> From<&'a HashMap<K, V, RandomState>> for HashMap<K, V, S> where
K: Hash + Eq + Clone,
V: Clone,
S: BuildHasher + Default,
impl<'a, K, V, S> From<&'a HashMap<K, V, RandomState>> for HashMap<K, V, S> where
K: Hash + Eq + Clone,
V: Clone,
S: BuildHasher + Default,
sourceimpl<'a, K: Ord + Hash + Eq + Clone, V: Clone, S: BuildHasher> From<&'a HashMap<K, V, S>> for OrdMap<K, V>
impl<'a, K: Ord + Hash + Eq + Clone, V: Clone, S: BuildHasher> From<&'a HashMap<K, V, S>> for OrdMap<K, V>
sourceimpl<'a, K, V, S> From<&'a Vec<(K, V), Global>> for HashMap<K, V, S> where
K: Hash + Eq + Clone,
V: Clone,
S: BuildHasher + Default,
impl<'a, K, V, S> From<&'a Vec<(K, V), Global>> for HashMap<K, V, S> where
K: Hash + Eq + Clone,
V: Clone,
S: BuildHasher + Default,
sourceimpl<'m, 'k, 'v, K, V, OK, OV, SA, SB> From<&'m HashMap<&'k K, &'v V, SA>> for HashMap<OK, OV, SB> where
K: Hash + Eq + ToOwned<Owned = OK> + ?Sized,
V: ToOwned<Owned = OV> + ?Sized,
OK: Hash + Eq + Clone + Borrow<K>,
OV: Borrow<V> + Clone,
SA: BuildHasher,
SB: BuildHasher + Default,
impl<'m, 'k, 'v, K, V, OK, OV, SA, SB> From<&'m HashMap<&'k K, &'v V, SA>> for HashMap<OK, OV, SB> where
K: Hash + Eq + ToOwned<Owned = OK> + ?Sized,
V: ToOwned<Owned = OV> + ?Sized,
OK: Hash + Eq + Clone + Borrow<K>,
OV: Borrow<V> + Clone,
SA: BuildHasher,
SB: BuildHasher + Default,
sourceimpl<K, V, S> From<BTreeMap<K, V>> for HashMap<K, V, S> where
K: Hash + Eq + Clone,
V: Clone,
S: BuildHasher + Default,
impl<K, V, S> From<BTreeMap<K, V>> for HashMap<K, V, S> where
K: Hash + Eq + Clone,
V: Clone,
S: BuildHasher + Default,
sourceimpl<K, V, S> From<HashMap<K, V, RandomState>> for HashMap<K, V, S> where
K: Hash + Eq + Clone,
V: Clone,
S: BuildHasher + Default,
impl<K, V, S> From<HashMap<K, V, RandomState>> for HashMap<K, V, S> where
K: Hash + Eq + Clone,
V: Clone,
S: BuildHasher + Default,
sourceimpl<K: Ord + Hash + Eq + Clone, V: Clone, S: BuildHasher> From<HashMap<K, V, S>> for OrdMap<K, V>
impl<K: Ord + Hash + Eq + Clone, V: Clone, S: BuildHasher> From<HashMap<K, V, S>> for OrdMap<K, V>
sourceimpl<K, V, S> From<Vec<(K, V), Global>> for HashMap<K, V, S> where
K: Hash + Eq + Clone,
V: Clone,
S: BuildHasher + Default,
impl<K, V, S> From<Vec<(K, V), Global>> for HashMap<K, V, S> where
K: Hash + Eq + Clone,
V: Clone,
S: BuildHasher + Default,
sourceimpl<K, V, S> FromIterator<(K, V)> for HashMap<K, V, S> where
K: Hash + Eq + Clone,
V: Clone,
S: BuildHasher + Default,
impl<K, V, S> FromIterator<(K, V)> for HashMap<K, V, S> where
K: Hash + Eq + Clone,
V: Clone,
S: BuildHasher + Default,
sourceimpl<'a, BK, K, V, S> Index<&'a BK> for HashMap<K, V, S> where
BK: Hash + Eq + ?Sized,
K: Hash + Eq + Borrow<BK>,
S: BuildHasher,
impl<'a, BK, K, V, S> Index<&'a BK> for HashMap<K, V, S> where
BK: Hash + Eq + ?Sized,
K: Hash + Eq + Borrow<BK>,
S: BuildHasher,
sourceimpl<'a, BK, K, V, S> IndexMut<&'a BK> for HashMap<K, V, S> where
BK: Hash + Eq + ?Sized,
K: Hash + Eq + Clone + Borrow<BK>,
V: Clone,
S: BuildHasher,
impl<'a, BK, K, V, S> IndexMut<&'a BK> for HashMap<K, V, S> where
BK: Hash + Eq + ?Sized,
K: Hash + Eq + Clone + Borrow<BK>,
V: Clone,
S: BuildHasher,
sourceimpl<'a, K, V, S> IntoIterator for &'a HashMap<K, V, S> where
K: Hash + Eq,
S: BuildHasher,
impl<'a, K, V, S> IntoIterator for &'a HashMap<K, V, S> where
K: Hash + Eq,
S: BuildHasher,
sourceimpl<K, V, S> IntoIterator for HashMap<K, V, S> where
K: Hash + Eq + Clone,
V: Clone,
S: BuildHasher,
impl<K, V, S> IntoIterator for HashMap<K, V, S> where
K: Hash + Eq + Clone,
V: Clone,
S: BuildHasher,
sourceimpl<K, V, S> Ord for HashMap<K, V, S> where
K: Hash + Eq + Ord + Clone,
V: Ord + Clone,
S: BuildHasher,
impl<K, V, S> Ord for HashMap<K, V, S> where
K: Hash + Eq + Ord + Clone,
V: Ord + Clone,
S: BuildHasher,
sourceimpl<K, V, S> PartialEq<HashMap<K, V, S>> for HashMap<K, V, S> where
K: Hash + Eq,
V: PartialEq,
S: BuildHasher,
impl<K, V, S> PartialEq<HashMap<K, V, S>> for HashMap<K, V, S> where
K: Hash + Eq,
V: PartialEq,
S: BuildHasher,
sourceimpl<K, V, S> PartialEq<HashMap<K, V, S>> for HashMap<K, V, S> where
K: Hash + Eq,
V: Eq,
S: BuildHasher,
impl<K, V, S> PartialEq<HashMap<K, V, S>> for HashMap<K, V, S> where
K: Hash + Eq,
V: Eq,
S: BuildHasher,
sourceimpl<K, V, S> PartialOrd<HashMap<K, V, S>> for HashMap<K, V, S> where
K: Hash + Eq + Clone + PartialOrd,
V: PartialOrd + Clone,
S: BuildHasher,
impl<K, V, S> PartialOrd<HashMap<K, V, S>> for HashMap<K, V, S> where
K: Hash + Eq + Clone + PartialOrd,
V: PartialOrd + Clone,
S: BuildHasher,
sourcefn partial_cmp(&self, other: &Self) -> Option<Ordering>
fn partial_cmp(&self, other: &Self) -> Option<Ordering>
This method returns an ordering between self
and other
values if one exists. Read more
1.0.0 · sourcefn lt(&self, other: &Rhs) -> bool
fn lt(&self, other: &Rhs) -> bool
This method tests less than (for self
and other
) and is used by the <
operator. Read more
1.0.0 · sourcefn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
sourceimpl<K, V, S> Serialize for HashMap<K, V, S> where
K: Serialize + Hash + Eq + Clone,
V: Serialize + Clone,
S: BuildHasher + Default,
impl<K, V, S> Serialize for HashMap<K, V, S> where
K: Serialize + Hash + Eq + Clone,
V: Serialize + Clone,
S: BuildHasher + Default,
sourceimpl<K, V, S> Sum<HashMap<K, V, S>> for HashMap<K, V, S> where
K: Hash + Eq + Clone,
V: Clone,
S: BuildHasher + Default,
impl<K, V, S> Sum<HashMap<K, V, S>> for HashMap<K, V, S> where
K: Hash + Eq + Clone,
V: Clone,
S: BuildHasher + Default,
impl<K, V, S> Eq for HashMap<K, V, S> where
K: Hash + Eq,
V: Eq,
S: BuildHasher,
Auto Trait Implementations
impl<K, V, S> RefUnwindSafe for HashMap<K, V, S> where
K: RefUnwindSafe,
S: RefUnwindSafe,
V: RefUnwindSafe,
impl<K, V, S> Send for HashMap<K, V, S> where
K: Send + Sync,
S: Send + Sync,
V: Send + Sync,
impl<K, V, S> Sync for HashMap<K, V, S> where
K: Send + Sync,
S: Send + Sync,
V: Send + Sync,
impl<K, V, S> Unpin for HashMap<K, V, S> where
K: Unpin,
V: Unpin,
impl<K, V, S> UnwindSafe for HashMap<K, V, S> where
K: UnwindSafe + RefUnwindSafe,
S: RefUnwindSafe,
V: UnwindSafe + RefUnwindSafe,
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
impl<T> Pointable for T
impl<T> Pointable for T
sourceimpl<T> ToOwned for T where
T: Clone,
impl<T> ToOwned for T where
T: Clone,
type Owned = T
type Owned = T
The resulting type after obtaining ownership.
sourcefn clone_into(&self, target: &mut T)
fn clone_into(&self, target: &mut T)
toowned_clone_into
)Uses borrowed data to replace owned data, usually by cloning. Read more