Enum Entry

pub enum Entry<'a, K, V> {
    Occupied(OccupiedEntry<'a, K, V>),
    Vacant(VacantEntry<'a, K, V>),
}

Entry for an existing key-value pair 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

impl<'a, K, V> Entry<'a, K, V>

pub fn or_insert(self, default: V) -> &'a mut V

Computes in O(1) time (amortized average).

pub fn or_insert_with<F>(self, call: F) -> &'a mut V

where F: FnOnce() -> V,

Computes in O(1) time (amortized average).

pub fn key(&self) -> &K

pub fn index(&self) -> usize

Return the index where the key-value pair exists or will be inserted.

pub fn and_modify<F>(self, f: F) -> Self

where F: FnOnce(&mut V),

Modifies the entry if it is occupied.

pub fn or_default(self) -> &'a mut V

where 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

impl<K: Debug, V: Debug> Debug for Entry<'_, K, V>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.