Struct hashbrown::hash_map::VacantEntry
source · [−]pub struct VacantEntry<'a, K, V, S, A: Allocator + Clone = Global> { /* private fields */ }
Expand description
A view into a vacant entry in a HashMap
.
It is part of the Entry
enum.
Examples
use hashbrown::hash_map::{Entry, HashMap, VacantEntry};
let mut map = HashMap::<&str, i32>::new();
let entry_v: VacantEntry<_, _, _> = match map.entry("a") {
Entry::Vacant(view) => view,
Entry::Occupied(_) => unreachable!(),
};
entry_v.insert(10);
assert!(map[&"a"] == 10 && map.len() == 1);
// Nonexistent key (insert and update)
match map.entry("b") {
Entry::Occupied(_) => unreachable!(),
Entry::Vacant(view) => {
let value = view.insert(2);
assert_eq!(*value, 2);
*value = 20;
}
}
assert!(map[&"b"] == 20 && map.len() == 2);
Implementations
sourceimpl<'a, K, V, S, A: Allocator + Clone> VacantEntry<'a, K, V, S, A>
impl<'a, K, V, S, A: Allocator + Clone> VacantEntry<'a, K, V, S, A>
sourcepub fn key(&self) -> &K
pub fn key(&self) -> &K
Gets a reference to the key that would be used when inserting a value
through the VacantEntry
.
Examples
use hashbrown::HashMap;
let mut map: HashMap<&str, u32> = HashMap::new();
assert_eq!(map.entry("poneyland").key(), &"poneyland");
sourcepub fn into_key(self) -> K
pub fn into_key(self) -> K
Take ownership of the key.
Examples
use hashbrown::hash_map::{Entry, HashMap};
let mut map: HashMap<&str, u32> = HashMap::new();
match map.entry("poneyland") {
Entry::Occupied(_) => panic!(),
Entry::Vacant(v) => assert_eq!(v.into_key(), "poneyland"),
}
sourcepub fn insert(self, value: V) -> &'a mut V where
K: Hash,
S: BuildHasher,
pub fn insert(self, value: V) -> &'a mut V where
K: Hash,
S: BuildHasher,
Sets the value of the entry with the VacantEntry’s key, and returns a mutable reference to it.
Examples
use hashbrown::HashMap;
use hashbrown::hash_map::Entry;
let mut map: HashMap<&str, u32> = HashMap::new();
if let Entry::Vacant(o) = map.entry("poneyland") {
o.insert(37);
}
assert_eq!(map["poneyland"], 37);
Trait Implementations
Auto Trait Implementations
impl<'a, K, V, S, A> RefUnwindSafe for VacantEntry<'a, K, V, S, A> where
A: RefUnwindSafe,
K: RefUnwindSafe,
S: RefUnwindSafe,
V: RefUnwindSafe,
impl<'a, K, V, S, A> Send for VacantEntry<'a, K, V, S, A> where
A: Send,
K: Send,
S: Send,
V: Send,
impl<'a, K, V, S, A> Sync for VacantEntry<'a, K, V, S, A> where
A: Sync,
K: Sync,
S: Sync,
V: Sync,
impl<'a, K, V, S, A> Unpin for VacantEntry<'a, K, V, S, A> where
K: Unpin,
impl<'a, K, V, S, A = Global> !UnwindSafe for VacantEntry<'a, K, V, S, A>
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