Struct ds_ext::map::OrdHashMap
source · pub struct OrdHashMap<K, V> { /* private fields */ }
Expand description
A HashMap
ordered by key using a OrdHashSet
Implementations§
source§impl<K, V> OrdHashMap<K, V>
impl<K, V> OrdHashMap<K, V>
sourcepub fn new() -> Self
pub fn new() -> Self
Construct a new OrdHashMap
.
sourcepub fn with_capacity(capacity: usize) -> Self
pub fn with_capacity(capacity: usize) -> Self
Construct a new OrdHashMap
with the given capacity
.
sourcepub fn len(&self) -> usize
pub fn len(&self) -> usize
Return the size of this OrdHashMap
.
source§impl<K: Eq + Hash + Ord, V> OrdHashMap<K, V>
impl<K: Eq + Hash + Ord, V> OrdHashMap<K, V>
sourcepub fn bisect<Cmp>(&self, cmp: Cmp) -> Option<&V>where
Cmp: Fn(&K) -> Option<Ordering> + Copy,
pub fn bisect<Cmp>(&self, cmp: Cmp) -> Option<&V>where Cmp: Fn(&K) -> Option<Ordering> + Copy,
Bisect this map to match a key using the provided comparison, and return its value (if any).
The first key for which the comparison returns Some(Ordering::Equal)
will be returned.
This method assumes that any partially-ordered keys (where cmp(key).is_none()
) lie at the
beginning and/or end of the distribution.
sourcepub fn clear(&mut self)
pub fn clear(&mut self)
Remove all entries from this OrdHashMap
.
sourcepub fn contains_key<Q>(&self, key: &Q) -> boolwhere
Arc<K>: Borrow<Q>,
Q: Eq + Hash + ?Sized,
pub fn contains_key<Q>(&self, key: &Q) -> boolwhere Arc<K>: Borrow<Q>, Q: Eq + Hash + ?Sized,
Return true
if there is an entry for the given key
in this OrdHashMap
.
sourcepub fn drain(&mut self) -> Drain<'_, K, V> ⓘ
pub fn drain(&mut self) -> Drain<'_, K, V> ⓘ
Drain all entries from this OrdHashMap
.
sourcepub fn extend<I: IntoIterator<Item = (K, V)>>(&mut self, iter: I)
pub fn extend<I: IntoIterator<Item = (K, V)>>(&mut self, iter: I)
Consume the iter
and insert all its elements into this OrdHashMap
.
sourcepub fn first(&self) -> Option<&V>
pub fn first(&self) -> Option<&V>
Borrow the first value in this OrdHashMap
.
sourcepub fn first_mut(&mut self) -> Option<&mut V>
pub fn first_mut(&mut self) -> Option<&mut V>
Borrow the first value in this OrdHashMap
mutably.
sourcepub fn get<Q>(&self, key: &Q) -> Option<&V>where
Arc<K>: Borrow<Q>,
Q: Eq + Hash + ?Sized,
pub fn get<Q>(&self, key: &Q) -> Option<&V>where Arc<K>: Borrow<Q>, Q: Eq + Hash + ?Sized,
Borrow the value at the given key
, if present.
sourcepub fn get_key_value<Q>(&self, key: &Q) -> Option<(&K, &V)>where
Arc<K>: Borrow<Q>,
Q: Eq + Hash + ?Sized,
pub fn get_key_value<Q>(&self, key: &Q) -> Option<(&K, &V)>where Arc<K>: Borrow<Q>, Q: Eq + Hash + ?Sized,
Borrow the entry at the given key
, if present.
sourcepub fn get_mut<Q>(&mut self, key: &Q) -> Option<&mut V>where
Arc<K>: Borrow<Q>,
Q: Eq + Hash + ?Sized,
pub fn get_mut<Q>(&mut self, key: &Q) -> Option<&mut V>where Arc<K>: Borrow<Q>, Q: Eq + Hash + ?Sized,
Borrow the value at the given key
mutably, if present.
sourcepub fn insert(&mut self, key: K, value: V) -> Option<V>
pub fn insert(&mut self, key: K, value: V) -> Option<V>
Insert a new value
at key
and return the previous value, if any.
sourcepub fn iter(&self) -> Iter<'_, K, V> ⓘ
pub fn iter(&self) -> Iter<'_, K, V> ⓘ
Construct an iterator over the entries in this OrdHashMap
.
sourcepub fn is_empty(&self) -> bool
pub fn is_empty(&self) -> bool
Return true
if this OrdHashMap
is empty.
sourcepub fn keys(&self) -> Keys<'_, K, V> ⓘ
pub fn keys(&self) -> Keys<'_, K, V> ⓘ
Construct an iterator over keys of this OrdHashMap
.
sourcepub fn last(&self) -> Option<&V>
pub fn last(&self) -> Option<&V>
Borrow the last value in this OrdHashMap
.
sourcepub fn last_mut(&mut self) -> Option<&mut V>
pub fn last_mut(&mut self) -> Option<&mut V>
Borrow the last value in this OrdHashMap
mutably.
sourcepub fn pop_first(&mut self) -> Option<V>
pub fn pop_first(&mut self) -> Option<V>
Remove and return the first value in this OrdHashMap
.
sourcepub fn pop_last(&mut self) -> Option<V>
pub fn pop_last(&mut self) -> Option<V>
Remove and return the last value in this OrdHashMap
.
sourcepub fn remove<Q>(&mut self, key: &Q) -> Option<V>where
Arc<K>: Borrow<Q>,
Q: Hash + Eq + ?Sized,
pub fn remove<Q>(&mut self, key: &Q) -> Option<V>where Arc<K>: Borrow<Q>, Q: Hash + Eq + ?Sized,
Remove an entry from this OrdHashMap
and return its value, if present.
sourcepub fn starts_with<'a, I: IntoIterator<Item = (&'a K, &'a V)>>(
&self,
other: I
) -> boolwhere
K: Debug + 'a,
V: PartialEq + 'a,
pub fn starts_with<'a, I: IntoIterator<Item = (&'a K, &'a V)>>( &self, other: I ) -> boolwhere K: Debug + 'a, V: PartialEq + 'a,
Return true
if the first elements in this OrdHashMap
equal those in the given iter
.
sourcepub fn into_values(self) -> IntoValues<K, V> ⓘ
pub fn into_values(self) -> IntoValues<K, V> ⓘ
Construct an owned iterator over the values in this OrdHashMap
.
sourcepub fn values(&self) -> Values<'_, K, V> ⓘ
pub fn values(&self) -> Values<'_, K, V> ⓘ
Construct an iterator over the values in this OrdHashMap
.
source§impl<K: Eq + Hash + Ord + Debug, V> OrdHashMap<K, V>
impl<K: Eq + Hash + Ord + Debug, V> OrdHashMap<K, V>
sourcepub fn bisect_and_remove<Cmp>(&mut self, cmp: Cmp) -> Option<(K, V)>where
Cmp: Fn(&K) -> Option<Ordering> + Copy,
pub fn bisect_and_remove<Cmp>(&mut self, cmp: Cmp) -> Option<(K, V)>where Cmp: Fn(&K) -> Option<Ordering> + Copy,
Bisect this map to match and remove an entry using the provided comparison.
The first key for which the comparison returns Some(Ordering::Equal)
will be returned.
This method assumes that any partially-ordered keys (where cmp(key).is_none()
) lie at the
beginning and/or end of the distribution.
sourcepub fn pop_first_entry(&mut self) -> Option<(K, V)>
pub fn pop_first_entry(&mut self) -> Option<(K, V)>
Remove and return the first entry in this OrdHashMap
.
sourcepub fn pop_last_entry(&mut self) -> Option<(K, V)>
pub fn pop_last_entry(&mut self) -> Option<(K, V)>
Remove and return the last entry in this OrdHashMap
.