Type Alias time::format_description::FormatItem
source · pub type FormatItem<'a> = BorrowedFormatItem<'a>;
BorrowedFormatItem
instead for clarityExpand description
A complete description of how to format and parse a type.
This alias exists for backwards-compatibility. It is recommended to use BorrowedFormatItem
for clarity, as it is more explicit that the data is borrowed rather than owned.
Aliased Type§
enum FormatItem<'a> {
Literal(&'a [u8]),
Component(Component),
Compound(&'a [BorrowedFormatItem<'a>]),
Optional(&'a BorrowedFormatItem<'a>),
First(&'a [BorrowedFormatItem<'a>]),
}
Variants§
Literal(&'a [u8])
Bytes that are formatted as-is.
Note: These bytes should be UTF-8, but are not required to be. The value is passed
through String::from_utf8_lossy
when necessary.
Component(Component)
A minimal representation of a single non-literal item.
Compound(&'a [BorrowedFormatItem<'a>])
A series of literals or components that collectively form a partial or complete description.
Optional(&'a BorrowedFormatItem<'a>)
A FormatItem
that may or may not be present when parsing. If parsing fails, there
will be no effect on the resulting struct
.
This variant has no effect on formatting, as the value is guaranteed to be present.
First(&'a [BorrowedFormatItem<'a>])
A series of FormatItem
s where, when parsing, the first successful parse is used. When
formatting, the first element of the slice is used. An empty slice is a no-op when
formatting or parsing.
Trait Implementations
source§impl<'a> Clone for BorrowedFormatItem<'a>
impl<'a> Clone for BorrowedFormatItem<'a>
source§fn clone(&self) -> BorrowedFormatItem<'a>
fn clone(&self) -> BorrowedFormatItem<'a>
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl Debug for BorrowedFormatItem<'_>
impl Debug for BorrowedFormatItem<'_>
source§impl<'a> From<&'a [BorrowedFormatItem<'_>]> for BorrowedFormatItem<'a>
impl<'a> From<&'a [BorrowedFormatItem<'_>]> for BorrowedFormatItem<'a>
source§fn from(items: &'a [BorrowedFormatItem<'_>]) -> Self
fn from(items: &'a [BorrowedFormatItem<'_>]) -> Self
source§impl From<Component> for BorrowedFormatItem<'_>
impl From<Component> for BorrowedFormatItem<'_>
source§impl PartialEq<&[BorrowedFormatItem<'_>]> for BorrowedFormatItem<'_>
impl PartialEq<&[BorrowedFormatItem<'_>]> for BorrowedFormatItem<'_>
source§impl PartialEq<Component> for BorrowedFormatItem<'_>
impl PartialEq<Component> for BorrowedFormatItem<'_>
source§impl<'a> PartialEq for BorrowedFormatItem<'a>
impl<'a> PartialEq for BorrowedFormatItem<'a>
source§fn eq(&self, other: &BorrowedFormatItem<'a>) -> bool
fn eq(&self, other: &BorrowedFormatItem<'a>) -> bool
self
and other
values to be equal, and is used
by ==
.