pub enum Entry<'a, K, V> {
Occupied(OccupiedEntry<'a, K, V>),
Vacant(VacantEntry<'a, K, V>),
}
Expand description
Entry for an existing key-value pair in an IndexMap
or a vacant location to insert one.
Variants§
Occupied(OccupiedEntry<'a, K, V>)
Existing slot with equivalent key.
Vacant(VacantEntry<'a, K, V>)
Vacant slot (no equivalent key in the map).
Implementations§
source§impl<'a, K, V> Entry<'a, K, V>
impl<'a, K, V> Entry<'a, K, V>
sourcepub fn index(&self) -> usize
pub fn index(&self) -> usize
Return the index where the key-value pair exists or will be inserted.
sourcepub fn or_insert(self, default: V) -> &'a mut V
pub fn or_insert(self, default: V) -> &'a mut V
Inserts the given default value in the entry if it is vacant and returns a mutable reference to it. Otherwise a mutable reference to an already existent value is returned.
Computes in O(1) time (amortized average).
sourcepub fn or_insert_with<F>(self, call: F) -> &'a mut Vwhere
F: FnOnce() -> V,
pub fn or_insert_with<F>(self, call: F) -> &'a mut Vwhere
F: FnOnce() -> V,
Inserts the result of the call
function in the entry if it is vacant and returns a mutable
reference to it. Otherwise a mutable reference to an already existent value is returned.
Computes in O(1) time (amortized average).
sourcepub fn or_insert_with_key<F>(self, call: F) -> &'a mut V
pub fn or_insert_with_key<F>(self, call: F) -> &'a mut V
Inserts the result of the call
function with a reference to the entry’s key if it is
vacant, and returns a mutable reference to the new value. Otherwise a mutable reference to
an already existent value is returned.
Computes in O(1) time (amortized average).
sourcepub fn key(&self) -> &K
pub fn key(&self) -> &K
Gets a reference to the entry’s key, either within the map if occupied, or else the new key that was used to find the entry.
sourcepub fn and_modify<F>(self, f: F) -> Self
pub fn and_modify<F>(self, f: F) -> Self
Modifies the entry if it is occupied.
sourcepub fn or_default(self) -> &'a mut Vwhere
V: Default,
pub fn or_default(self) -> &'a mut Vwhere
V: Default,
Inserts a default-constructed value in the entry if it is vacant and returns a mutable reference to it. Otherwise a mutable reference to an already existent value is returned.
Computes in O(1) time (amortized average).
Trait Implementations§
source§impl<K, V> MutableEntryKey for Entry<'_, K, V>
impl<K, V> MutableEntryKey for Entry<'_, K, V>
Opt-in mutable access to Entry
keys.
See MutableEntryKey
for more information.