Struct Separator

pub struct Separator<'a>(/* private fields */);

For alternate flag-aware separation of fields, collection elements, etc.

Example

use const_panic::{
    fmt::{self, FmtArg, IsLast, Separator},
    ArrayString,
    flatten_panicvals,
};

const SEMICOLON_SEP: Separator = Separator::new(";", IsLast::No);
const SEMICOLON_TERM: Separator = Separator::new(";", IsLast::Yes);

// Debug formatting
assert_eq!(
    const_panic::concat_!(FmtArg::DEBUG;
        open: fmt::OpenBrace,
            debug: "foo", SEMICOLON_SEP,
            [3u8, 5, 8], SEMICOLON_SEP,
            false, SEMICOLON_TERM,
        close: fmt::CloseBrace,
    ),
    // the space before the brace is because Delimiter is intended for
    // formatting structs and enum variants.
    " { \"foo\"; [3, 5, 8]; false }"
);


// Alternate-Debug formatting
assert_eq!(
    const_panic::concat_!(FmtArg::ALT_DEBUG;
        open: fmt::OpenBrace,
            debug: "foo", SEMICOLON_SEP,
            debug: [3u8, 5, 8], SEMICOLON_SEP,
            false, SEMICOLON_TERM,
        close: fmt::CloseBrace,
    ),
    concat!(
        " {\n",
        "    \"foo\";\n",
        "    [3, 5, 8];\n",
        "    false;\n",
        "}",
    )
);

Implementations

impl<'a> Separator<'a>

pub const fn new(string: &'a str, is_last_field: IsLast) -> Self

Constructs a Separator from a custom separator.

Panics

Panics if string is longer than 12 bytes.

pub const fn to_panicvals(self, f: FmtArg) -> [PanicVal<'static>; 1]

Converts this Separator into an array of one PanicVal. Otherwise does the same as to_panicval

pub const fn to_panicval(self, f: FmtArg) -> PanicVal<'static>

Converts this Separator into a PanicVal.

When the alternate flag is enabled, this and the to_panicvals method output:

• the separator
• a newline
• fmtarg.indentation amount of spaces if constructed with IsLast::No

When the alternate flag is disabled, these methods output the separator and a single space if constructed with IsLast::No, otherwise output nothing.

Trait Implementations

impl<'a> Clone for Separator<'a>

fn clone(&self) -> Separator<'a>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl PanicFmt for Separator<'_>

const PV_COUNT: usize = 1usize

The length of the array returned in Self::to_panicvals (an inherent method that formats the type for panic messages).

type This = Separator<'_>

The type after dereferencing all references.

type Kind = IsCustomType

Whether this is a user-defined type or standard library type.

const PROOF: IsPanicFmt<Self, Self::This, Self::Kind> = IsPanicFmt::NEW

A marker type that proves that Self implements PanicFmt.

impl<'a> Copy for Separator<'a>