pub enum Entry<'a, K: 'a, V: 'a, S: 'a> {
Occupied(OccupiedEntry<'a, K, V, S>),
Vacant(VacantEntry<'a, K, V, S>),
}
Expand description
Variants
Occupied(OccupiedEntry<'a, K, V, S>)
An occupied entry.
Vacant(VacantEntry<'a, K, V, S>)
A vacant entry.
Implementations
sourceimpl<'a, K: Eq + Hash, V, S: BuildHasher> Entry<'a, K, V, S>
impl<'a, K: Eq + Hash, V, S: BuildHasher> Entry<'a, K, V, S>
sourcepub fn or_insert(self, default: V) -> &'a mut V
pub fn or_insert(self, default: V) -> &'a mut V
Ensures a value is in the entry by inserting the default if empty, and returns a mutable reference to the value in the entry.
Examples
use hashbrown::HashMap;
let mut map: HashMap<&str, u32> = HashMap::new();
map.entry("poneyland").or_insert(12);
assert_eq!(map["poneyland"], 12);
*map.entry("poneyland").or_insert(12) += 10;
assert_eq!(map["poneyland"], 22);
sourcepub fn or_insert_with<F: FnOnce() -> V>(self, default: F) -> &'a mut V
pub fn or_insert_with<F: FnOnce() -> V>(self, default: F) -> &'a mut V
Ensures a value is in the entry by inserting the result of the default function if empty, and returns a mutable reference to the value in the entry.
Examples
use hashbrown::HashMap;
let mut map: HashMap<&str, String> = HashMap::new();
let s = "hoho".to_string();
map.entry("poneyland").or_insert_with(|| s);
assert_eq!(map["poneyland"], "hoho".to_string());
sourcepub fn key(&self) -> &K
pub fn key(&self) -> &K
Returns a reference to this entry’s key.
Examples
use hashbrown::HashMap;
let mut map: HashMap<&str, u32> = HashMap::new();
assert_eq!(map.entry("poneyland").key(), &"poneyland");
sourcepub fn and_modify<F>(self, f: F) -> Selfwhere
F: FnOnce(&mut V),
pub fn and_modify<F>(self, f: F) -> Selfwhere
F: FnOnce(&mut V),
Provides in-place mutable access to an occupied entry before any potential inserts into the map.
Examples
use hashbrown::HashMap;
let mut map: HashMap<&str, u32> = HashMap::new();
map.entry("poneyland")
.and_modify(|e| { *e += 1 })
.or_insert(42);
assert_eq!(map["poneyland"], 42);
map.entry("poneyland")
.and_modify(|e| { *e += 1 })
.or_insert(42);
assert_eq!(map["poneyland"], 43);
sourceimpl<'a, K: Eq + Hash, V: Default, S: BuildHasher> Entry<'a, K, V, S>
impl<'a, K: Eq + Hash, V: Default, S: BuildHasher> Entry<'a, K, V, S>
sourcepub fn or_default(self) -> &'a mut V
pub fn or_default(self) -> &'a mut V
Ensures a value is in the entry by inserting the default value if empty, and returns a mutable reference to the value in the entry.
Examples
use hashbrown::HashMap;
let mut map: HashMap<&str, Option<u32>> = HashMap::new();
map.entry("poneyland").or_default();
assert_eq!(map["poneyland"], None);
Trait Implementations
Auto Trait Implementations
impl<'a, K, V, S> RefUnwindSafe for Entry<'a, K, V, S>where
K: RefUnwindSafe,
S: RefUnwindSafe,
V: RefUnwindSafe,
impl<'a, K, V, S> Send for Entry<'a, K, V, S>where
K: Send,
S: Send,
V: Send,
impl<'a, K, V, S> Sync for Entry<'a, K, V, S>where
K: Sync,
S: Sync,
V: Sync,
impl<'a, K, V, S> Unpin for Entry<'a, K, V, S>where
K: Unpin,
impl<'a, K, V, S> !UnwindSafe for Entry<'a, K, V, S>
Blanket Implementations
sourceimpl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
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