Macro format_macro::lazy_format

lazy_format!() { /* proc-macro */ }

Lazy format macro

The first form receives closure as the only one argument.

let a = "a";
lazy_format!(|f| write!(f, "{}", a));

The second form is syntax sugar of the first form which is a closure with the only one write macro. Its syntax is identical to the format syntax.

let a = "a";
lazy_format!("{}", a);

The second form inferences the output format.

Format inference rules:

• has only Debug formats - Debug
• has formats of only one kind from: Binary, LowerExp, LowerHex, Octal, Pointer, UpperExp or UpperHex - Binary, LowerExp, LowerHex, Octal, Pointer, UpperExp or UpperHex respectively
• otherwise - Display

Examples

Nested Debug help struct example

#![feature(proc_macro_hygiene)]

use format::lazy_format;
use std::fmt;

struct Foo {
    bar: [u32; 9],
}

impl fmt::Debug for Foo {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        let bar = lazy_format!(|f| f.debug_list().entries(&self.bar).finish());
        f.debug_struct("Foo").field("bar", &bar).finish()
    }
}

Control flow example

#![feature(proc_macro_hygiene)]

use format::lazy_format;
use std::fmt;

struct Foo(usize);

impl fmt::Display for Foo {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        let bar = lazy_format!(|f| if f.alternate() {
            write!(f, "{:#x}", self.0)
        } else {
            write!(f, "{:x}", self.0)
        });
        f.debug_tuple("Foo").field(&bar).finish()
    }
}