Enum Item

pub enum Item<'a> {
    Literal(&'a str),
    OwnedLiteral(Box<str>),
    Space(&'a str),
    OwnedSpace(Box<str>),
    Numeric(Numeric, Pad),
    Fixed(Fixed),
    Error,
}

A single formatting item. This is used for both formatting and parsing.

Variants

Literal(&'a str)

A literally printed and parsed text.

OwnedLiteral(Box<str>)

Available on crate feature alloc only.

Same as Literal but with the string owned by the item.

Space(&'a str)

Whitespace. Prints literally but reads zero or more whitespace.

OwnedSpace(Box<str>)

Available on crate feature alloc only.

Same as Space but with the string owned by the item.

Numeric(Numeric, Pad)

Numeric item. Can be optionally padded to the maximal length (if any) when formatting; the parser simply ignores any padded whitespace and zeroes.

Fixed(Fixed)

Fixed-format item.

Error

Issues a formatting error. Used to signal an invalid format string.

Implementations

impl Item<'_>

pub fn to_owned(self) -> Item<'static>

Available on crate features alloc or std only.

Convert items that contain a reference to the format string into an owned variant.

Trait Implementations

impl<'a> Clone for Item<'a>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Item<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'a> Hash for Item<'a>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<'a> PartialEq for Item<'a>

fn eq(&self, other: &Item<'a>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> Eq for Item<'a>

impl<'a> StructuralPartialEq for Item<'a>