Enum std::collections::hash_map::Entry

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

map 中单个条目的视图，该条目可能是空的或被已占用。

enum 是根据 HashMap 上的 entry 方法构造的。

Variants

Occupied(OccupiedEntry<'a, K, V>)

Tuple Fields

0: OccupiedEntry<'a, K, V>

一个被占用的条目。

Vacant(VacantEntry<'a, K, V>)

Tuple Fields

0: VacantEntry<'a, K, V>

一个空的条目。

Implementations

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

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

如果为空，则通过插入默认值来确保该值在条目中，并返回对条目中值的可变引用。

Examples

use std::collections::HashMap;

let mut map: HashMap<&str, u32> = HashMap::new();

map.entry("poneyland").or_insert(3);
assert_eq!(map["poneyland"], 3);

*map.entry("poneyland").or_insert(10) *= 2;
assert_eq!(map["poneyland"], 6);

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

如果为空，则通过插入默认函数的结果来确保该值在条目中，并返回对条目中值的可变引用。

Examples

use std::collections::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());

pub fn or_insert_with_key<F: FnOnce(&K) -> V>(self, default: F) -> &'a mut V

如果为空，则通过插入默认函数的结果，确保值在条目中。 通过为 .entry(key) 方法调用期间移动的键提供默认函数引用，此方法可以生成用于插入的键派生值。

提供了对已移动键的引用，因此不需要克隆或复制键，这与 .or_insert_with(|| ... ) 不同。

Examples

use std::collections::HashMap;

let mut map: HashMap<&str, usize> = HashMap::new();

map.entry("poneyland").or_insert_with_key(|key| key.chars().count());

assert_eq!(map["poneyland"], 9);

pub fn key(&self) -> &K

返回此条目的键的引用。

Examples

use std::collections::HashMap;

let mut map: HashMap<&str, u32> = HashMap::new();
assert_eq!(map.entry("poneyland").key(), &"poneyland");

pub fn and_modify<F>(self, f: F) -> Self where
    F: FnOnce(&mut V), 

在任何潜在的插入 map 之前，提供对占用条目的就地可变访问。

Examples

use std::collections::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);

pub fn insert_entry(self, value: V) -> OccupiedEntry<'a, K, V>

🔬 This is a nightly-only experimental API. (entry_insert #65225)

设置条目的值，并返回 OccupiedEntry。

Examples

#![feature(entry_insert)]
use std::collections::HashMap;

let mut map: HashMap<&str, String> = HashMap::new();
let entry = map.entry("poneyland").insert_entry("hoho".to_string());

assert_eq!(entry.key(), &"poneyland");

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

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

如果为空，则通过插入默认值来确保值在条目中，并向条目中的值返回变量引用。

Examples

use std::collections::HashMap;

let mut map: HashMap<&str, Option<u32>> = HashMap::new();
map.entry("poneyland").or_default();

assert_eq!(map["poneyland"], None);

Trait Implementations

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

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

使用给定的格式化程序格式化该值。