Trait std::fmt::Debug

1.0.0 · source ·

pub trait Debug {
    // Required method
    fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>;
}

Expand description

? 格式。

Debug 应该在面向程序员的调试上下文中格式化输出。

一般来说，您应该只将 derive 和 Debug 实现。

当与备用格式说明符 #? 一起使用时，输出将被漂亮地打印。

有关格式化程序的更多信息，请参见模块级文档。

如果所有字段都实现 Debug，则此 trait 可以与 #[derive] 一起使用。当为结构体 derived' 时，它将使用 struct的名称，然后是{，然后是每个字段名称和 Debug值的逗号分隔列表，然后是}。对于 enum，它将使用变体的名称，如果适用，将使用 (，然后是字段的 Debug值，然后是)`。

Stability

派生的 Debug 格式不稳定，因此 future Rust 版本可能会更改。此外，标准库 (std、core、alloc 等) 提供的类型的 Debug 实现并不稳定，并且也可能随着 future Rust 版本而改变。

Examples

派生实现：

#[derive(Debug)]
struct Point {
    x: i32,
    y: i32,
}

let origin = Point { x: 0, y: 0 };

assert_eq!(format!("The origin is: {origin:?}"), "The origin is: Point { x: 0, y: 0 }");

Run

手动实现：

use std::fmt;

struct Point {
    x: i32,
    y: i32,
}

impl fmt::Debug for Point {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        f.debug_struct("Point")
         .field("x", &self.x)
         .field("y", &self.y)
         .finish()
    }
}

let origin = Point { x: 0, y: 0 };

assert_eq!(format!("The origin is: {origin:?}"), "The origin is: Point { x: 0, y: 0 }");

Run

Formatter 结构体上有许多辅助方法可以帮助您实现手动实现，例如 debug_struct。

不希望使用 Formatter trait 提供的标准调试表示套件 (debug_struct、debug_tuple、debug_list、debug_set、debug_map) 的类型可以通过手动向 Formatter 写入任意表示来完成完全自定义的操作。

impl fmt::Debug for Point {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        write!(f, "Point [{} {}]", self.x, self.y)
    }
}

Run

使用 derive 或 Formatter 上的调试构建器 API 的 Debug 实现支持使用备用标志 {:#?} 的漂亮打印。

使用 #? 进行漂亮的打印：

#[derive(Debug)]
struct Point {
    x: i32,
    y: i32,
}

let origin = Point { x: 0, y: 0 };

assert_eq!(format!("The origin is: {origin:#?}"),
"The origin is: Point {
    x: 0,
    y: 0,
}");

Run

Required Methods§

source

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

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

Examples

use std::fmt;

struct Position {
    longitude: f32,
    latitude: f32,
}

impl fmt::Debug for Position {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        f.debug_tuple("")
         .field(&self.longitude)
         .field(&self.latitude)
         .finish()
    }
}

let position = Position { longitude: 1.987, latitude: 2.983 };
assert_eq!(format!("{position:?}"), "(1.987, 2.983)");

assert_eq!(format!("{position:#?}"), "(
    1.987,
    2.983,
)");

Trait std::fmt::Debug

Stability

Examples

Required Methods§

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

Examples

Implementors§

impl Debug for AsciiChar

impl Debug for BacktraceStatus

impl Debug for std::cmp::Ordering

impl Debug for TryReserveErrorKind

impl Debug for Infallible

impl Debug for VarError

impl Debug for c_void

impl Debug for ErrorKind

impl Debug for SeekFrom

impl Debug for IpAddr

impl Debug for Ipv6MulticastScope

impl Debug for Shutdown

impl Debug for std::net::SocketAddr

impl Debug for FpCategory

impl Debug for IntErrorKind

impl Debug for AncillaryError

impl Debug for BacktraceStyle

impl Debug for Which

impl Debug for SearchStep

impl Debug for std::sync::atomic::Ordering

impl Debug for RecvTimeoutError

impl Debug for TryRecvError

impl Debug for std::fmt::Alignment

impl Debug for bool

impl Debug for char

impl Debug for f32

impl Debug for f64

impl Debug for i8

impl Debug for i16

impl Debug for i32

impl Debug for i64

impl Debug for i128

impl Debug for isize

impl Debug for !

impl Debug for str

impl Debug for u8

impl Debug for u16

impl Debug for u32

impl Debug for u64

impl Debug for u128

impl Debug for ()

impl Debug for usize

impl Debug for CpuidResult

impl Debug for __m128

impl Debug for __m128bh

impl Debug for __m128d

impl Debug for __m128i

impl Debug for __m256

impl Debug for __m256bh

impl Debug for __m256d

impl Debug for __m256i

impl Debug for __m512

impl Debug for __m512bh

impl Debug for __m512d

impl Debug for __m512i

impl Debug for FromBytesUntilNulError

impl Debug for TimSortRun

impl Debug for AllocError

impl Debug for Global

impl Debug for Layout

impl Debug for LayoutError

impl Debug for System

impl Debug for TypeId

impl Debug for TryFromSliceError

impl Debug for std::ascii::EscapeDefault

impl Debug for Backtrace

impl Debug for BacktraceFrame

impl Debug for BorrowError

impl Debug for BorrowMutError

impl Debug for CharTryFromError

impl Debug for DecodeUtf16Error

impl Debug for std::char::EscapeDebug

impl Debug for std::char::EscapeDefault