Enum std::collections::btree_map::Entry

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

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

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

Variants

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

一个空的条目。

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

一个被占用的条目。

Implementations

impl<'a, K, V> Entry<'a, K, V> where
    K: Ord, 

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

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

Examples

use std::collections::BTreeMap;

let mut map: BTreeMap<&str, usize> = BTreeMap::new();
map.entry("poneyland").or_insert(12);

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

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

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

Examples

use std::collections::BTreeMap;

let mut map: BTreeMap<&str, String> = BTreeMap::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>(self, default: F) -> &'a mut V where
    F: FnOnce(&K) -> V, 

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

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

Examples

use std::collections::BTreeMap;

let mut map: BTreeMap<&str, usize> = BTreeMap::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::BTreeMap;

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

pub fn and_modify<F>(self, f: F) -> Entry<'a, K, V> where
    F: FnOnce(&mut V), 

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

Examples

use std::collections::BTreeMap;

let mut map: BTreeMap<&str, usize> = BTreeMap::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);

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

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

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

Examples

use std::collections::BTreeMap;

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

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

Trait Implementations

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

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

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