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。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。