pub struct DebugTuple<'f, 'w> { /* private fields */ }
Available on crate feature fmt only.
Expand description

For debug formatting a tuple struct, or tuple variant.

Example

This example demonstrates how you can debug format a tuple struct, and an enum of tuple variants.

#![feature(const_mut_refs)]

use const_format::{Error, Formatter};
use const_format::{call_debug_fmt, coerce_to_fmt, formatc, impl_fmt, try_};

fn main() {
    const STRUC: &str = formatc!("{:?}", Foo(5, [8, 13, 21], "34"));
    const ENUM_: &str = formatc!("{:?}", Bar::Baz(false, None));
     
    assert_eq!(STRUC, "Foo(5, [8, 13, 21], \"34\")");
    assert_eq!(ENUM_, "Baz(false, None)");
}

struct Foo(u32, [u32; 3], &'static str);

enum Bar {
    Baz(bool, Option<bool>),
}

impl_fmt!{
    impl Foo;
     
    const fn const_debug_fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error> {
        let mut f = f.debug_tuple("Foo");
        try_!(coerce_to_fmt!(&self.0).const_debug_fmt(f.field()));
        try_!(coerce_to_fmt!(&self.1).const_debug_fmt(f.field()));
        try_!(coerce_to_fmt!(&self.2).const_debug_fmt(f.field()));
        f.finish()
    }
}

impl_fmt!{
    impl Bar;
     
    const fn const_debug_fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error> {
        match self {
            Bar::Baz(f0, f1) => {
                let mut f = f.debug_tuple("Baz");
                 
                // This macro allows debug formatting some generic types that
                // don't have a const_debug_fmt fn, like Options which wrap non-std types.
                call_debug_fmt!(std, f0, f.field());
                call_debug_fmt!(Option, f1, f.field());
                 
                f.finish()
            }
        }
    }
}


Implementations§

source§

impl<'f, 'w> DebugTuple<'f, 'w>

source

pub const fn field(&mut self) -> &mut Formatter<'w>

Adds a field to the formatted output.

source

pub const fn finish(self) -> Result<(), Error>

Finishes writing the tuple struct/variant, and if anything went wrong in the field method,returns an error.

Auto Trait Implementations§

§

impl<'f, 'w> RefUnwindSafe for DebugTuple<'f, 'w>

§

impl<'f, 'w> Send for DebugTuple<'f, 'w>

§

impl<'f, 'w> Sync for DebugTuple<'f, 'w>

§

impl<'f, 'w> Unpin for DebugTuple<'f, 'w>

§

impl<'f, 'w> !UnwindSafe for DebugTuple<'f, 'w>

Blanket Implementations§

source§

impl<T> Any for Twhere T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for Twhere T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for Twhere T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for Twhere U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.