Rust DebugMap.key用法及代码示例

本文简要介绍rust语言中 std::fmt::DebugMap.key 的用法。

用法

pub fn key(&mut self, key: &dyn Debug) -> &mut DebugMap<'a, 'b>

将新条目的关键部分添加到映射输出。

此方法与 value 一起是 entry 的替代方法，可在预先不知道完整条目时使用。如果可以使用，请首选 entry 方法。

Panics

key 必须在 value 之前调用，并且每次对 key 的调用必须跟在对 value 的相应调用之后。否则这个方法会Panics。

例子

use std::fmt;

struct Foo(Vec<(String, i32)>);

impl fmt::Debug for Foo {
    fn fmt(&self, fmt: &mut fmt::Formatter<'_>) -> fmt::Result {
        fmt.debug_map()
           .key(&"whole").value(&self.0) // We add the "whole" entry.
           .finish()
    }
}

assert_eq!(
    format!("{:?}", Foo(vec![("A".to_string(), 10), ("B".to_string(), 11)])),
    "{\"whole\": [(\"A\", 10), (\"B\", 11)]}",
);

相关用法

注：本文由纯净天空筛选整理自rust-lang.org大神的英文原创作品 std::fmt::DebugMap.key。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。