Enum std::collections::btree_map::Entry

pub enum Entry<'a, K, V, A = Global>where
    K: 'a,
    V: 'a,
    A: Allocator + Clone,{
    Vacant(VacantEntry<'a, K, V, A>),
    Occupied(OccupiedEntry<'a, K, V, A>),
}

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

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

Variants

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

一个空的条目。

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

一个被占用的条目。

Implementations

impl<'a, K, V, A> Entry<'a, K, V, A>where K: Ord, A: Allocator + Clone,

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 Vwhere 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 Vwhere 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, A>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, A> Entry<'a, K, V, A>where K: Ord, V: Default, A: Allocator + Clone,

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, A> Debug for Entry<'_, K, V, A>where K: Debug + Ord, V: Debug, A: Allocator + Clone,

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

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