rust_format

Macro _blank_

Source
macro_rules! _blank_ {
    () => { ... };
    ($lit:literal) => { ... };
}
Available on crate feature post_process only.
Expand description

A “marker” macro used to mark locations in the source code where blank lines should be inserted. If no parameter is given, one blank line is assumed, otherwise the integer literal specified gives the # of blank lines to insert.

It is important to understand this is NOT actually a macro that is executed. In fact, it is just here for documentation purposes. Instead, this works as a raw set of tokens in the source code that we match against verbatim. This means it cannot be renamed on import for example, and it MUST be invoked as _blank_!(, then an optional Rust integer literal, and then );.

Actually executing this macro has no effect and it is not meant to even be imported.