Struct rustc_feature::fmt::DebugList 1.2.0[−][src]
pub struct DebugList<'a, 'b> where
'b: 'a, {
inner: DebugInner<'a, 'b>,
}Expand description
A struct to help with fmt::Debug implementations.
This is useful when you wish to output a formatted list of items as a part
of your Debug::fmt implementation.
This can be constructed by the Formatter::debug_list method.
Examples
use std::fmt;
struct Foo(Vec<i32>);
impl fmt::Debug for Foo {
fn fmt(&self, fmt: &mut fmt::Formatter) -> fmt::Result {
fmt.debug_list().entries(self.0.iter()).finish()
}
}
assert_eq!(
format!("{:?}", Foo(vec![10, 11])),
"[10, 11]",
);Fields
inner: DebugInner<'a, 'b>Implementations
Adds a new entry to the list output.
Examples
use std::fmt;
struct Foo(Vec<i32>, Vec<u32>);
impl fmt::Debug for Foo {
fn fmt(&self, fmt: &mut fmt::Formatter<'_>) -> fmt::Result {
fmt.debug_list()
.entry(&self.0) // We add the first "entry".
.entry(&self.1) // We add the second "entry".
.finish()
}
}
assert_eq!(
format!("{:?}", Foo(vec![10, 11], vec![12, 13])),
"[[10, 11], [12, 13]]",
);pub fn entries<D, I>(&mut self, entries: I) -> &mut DebugList<'a, 'b> where
D: Debug,
I: IntoIterator<Item = D>,
pub fn entries<D, I>(&mut self, entries: I) -> &mut DebugList<'a, 'b> where
D: Debug,
I: IntoIterator<Item = D>,
Adds the contents of an iterator of entries to the list output.
Examples
use std::fmt;
struct Foo(Vec<i32>, Vec<u32>);
impl fmt::Debug for Foo {
fn fmt(&self, fmt: &mut fmt::Formatter<'_>) -> fmt::Result {
fmt.debug_list()
.entries(self.0.iter())
.entries(self.1.iter())
.finish()
}
}
assert_eq!(
format!("{:?}", Foo(vec![10, 11], vec![12, 13])),
"[10, 11, 12, 13]",
);Finishes output and returns any error encountered.
Examples
use std::fmt;
struct Foo(Vec<i32>);
impl fmt::Debug for Foo {
fn fmt(&self, fmt: &mut fmt::Formatter<'_>) -> fmt::Result {
fmt.debug_list()
.entries(self.0.iter())
.finish() // Ends the struct formatting.
}
}
assert_eq!(
format!("{:?}", Foo(vec![10, 11])),
"[10, 11]",
);Auto Trait Implementations
impl<'a, 'b> !RefUnwindSafe for DebugList<'a, 'b>
impl<'a, 'b> !UnwindSafe for DebugList<'a, 'b>
Blanket Implementations
Layout
Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference’s “Type Layout” chapter for details on type layout guarantees.
Size: 16 bytes