Enum time::format_description::FormatItem
source · #[non_exhaustive]
pub enum FormatItem<'a> {
Literal(&'a [u8]),
Component(Component),
Compound(&'a [Self]),
Optional(&'a Self),
First(&'a [Self]),
}Available on crate features
formatting or parsing only.Expand description
A complete description of how to format and parse a type.
Variants (Non-exhaustive)
This enum is marked as non-exhaustive
Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.
Literal(&'a [u8])
Bytes that are formatted as-is.
Note: If you call the format method that returns a String, these bytes will be
passed through String::from_utf8_lossy.
Component(Component)
A minimal representation of a single non-literal item.
Compound(&'a [Self])
A series of literals or components that collectively form a partial or complete description.
Optional(&'a Self)
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 [Self])
A series of FormatItems 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
sourceimpl<'a> Clone for BorrowedFormatItem<'a>
impl<'a> Clone for BorrowedFormatItem<'a>
sourcefn clone(&self) -> BorrowedFormatItem<'a>ⓘNotable traits for FormatItem<'_>impl Formattable for FormatItem<'_>impl Parsable for FormatItem<'_>
fn clone(&self) -> BorrowedFormatItem<'a>ⓘNotable traits for FormatItem<'_>impl Formattable for FormatItem<'_>impl Parsable for FormatItem<'_>
Returns a copy of the value. Read more
1.0.0 · sourcefn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from
source. Read moresourceimpl Debug for BorrowedFormatItem<'_>
Available on crate feature alloc only.
impl Debug for BorrowedFormatItem<'_>
Available on crate feature
alloc only.sourceimpl<'a> From<&'a [BorrowedFormatItem<'_>]> for BorrowedFormatItem<'a>
impl<'a> From<&'a [BorrowedFormatItem<'_>]> for BorrowedFormatItem<'a>
sourcefn from(items: &'a [BorrowedFormatItem<'_>]) -> Self
fn from(items: &'a [BorrowedFormatItem<'_>]) -> Self
Converts to this type from the input type.
sourceimpl From<&BorrowedFormatItem<'_>> for OwnedFormatItem
Available on crate feature alloc only.
impl From<&BorrowedFormatItem<'_>> for OwnedFormatItem
Available on crate feature
alloc only.sourcefn from(item: &FormatItem<'_>) -> Self
fn from(item: &FormatItem<'_>) -> Self
Converts to this type from the input type.
sourceimpl From<BorrowedFormatItem<'_>> for OwnedFormatItem
Available on crate feature alloc only.
impl From<BorrowedFormatItem<'_>> for OwnedFormatItem
Available on crate feature
alloc only.sourcefn from(item: FormatItem<'_>) -> Self
fn from(item: FormatItem<'_>) -> Self
Converts to this type from the input type.
sourceimpl From<Component> for BorrowedFormatItem<'_>
impl From<Component> for BorrowedFormatItem<'_>
sourceimpl PartialEq<&[BorrowedFormatItem<'_>]> for BorrowedFormatItem<'_>
impl PartialEq<&[BorrowedFormatItem<'_>]> for BorrowedFormatItem<'_>
sourceimpl PartialEq<BorrowedFormatItem<'_>> for &[BorrowedFormatItem<'_>]
impl PartialEq<BorrowedFormatItem<'_>> for &[BorrowedFormatItem<'_>]
sourcefn eq(&self, rhs: &BorrowedFormatItem<'_>) -> bool
fn eq(&self, rhs: &BorrowedFormatItem<'_>) -> bool
sourceimpl PartialEq<BorrowedFormatItem<'_>> for Component
impl PartialEq<BorrowedFormatItem<'_>> for Component
sourcefn eq(&self, rhs: &BorrowedFormatItem<'_>) -> bool
fn eq(&self, rhs: &BorrowedFormatItem<'_>) -> bool
sourceimpl<'a> PartialEq<BorrowedFormatItem<'a>> for BorrowedFormatItem<'a>
impl<'a> PartialEq<BorrowedFormatItem<'a>> for BorrowedFormatItem<'a>
sourcefn eq(&self, other: &BorrowedFormatItem<'a>) -> bool
fn eq(&self, other: &BorrowedFormatItem<'a>) -> bool
sourceimpl PartialEq<Component> for BorrowedFormatItem<'_>
impl PartialEq<Component> for BorrowedFormatItem<'_>
sourceimpl TryFrom<BorrowedFormatItem<'_>> for Component
impl TryFrom<BorrowedFormatItem<'_>> for Component
type Error = DifferentVariant
type Error = DifferentVariant
The type returned in the event of a conversion error.
sourcefn try_from(value: BorrowedFormatItem<'_>) -> Result<Self, Self::Error>
fn try_from(value: BorrowedFormatItem<'_>) -> Result<Self, Self::Error>
Performs the conversion.
sourceimpl<'a> TryFrom<BorrowedFormatItem<'a>> for &[BorrowedFormatItem<'a>]
impl<'a> TryFrom<BorrowedFormatItem<'a>> for &[BorrowedFormatItem<'a>]
type Error = DifferentVariant
type Error = DifferentVariant
The type returned in the event of a conversion error.
sourcefn try_from(value: BorrowedFormatItem<'a>) -> Result<Self, Self::Error>
fn try_from(value: BorrowedFormatItem<'a>) -> Result<Self, Self::Error>
Performs the conversion.
impl<'a> Eq for BorrowedFormatItem<'a>
impl Formattable for FormatItem<'_>
Available on crate feature
formatting only.impl Parsable for FormatItem<'_>
Available on crate feature
parsing only.impl<'a> StructuralEq for BorrowedFormatItem<'a>
impl<'a> StructuralPartialEq for BorrowedFormatItem<'a>
Auto Trait Implementations
impl<'a> RefUnwindSafe for BorrowedFormatItem<'a>
impl<'a> Send for BorrowedFormatItem<'a>
impl<'a> Sync for BorrowedFormatItem<'a>
impl<'a> Unpin for BorrowedFormatItem<'a>
impl<'a> UnwindSafe for BorrowedFormatItem<'a>
Blanket Implementations
sourceimpl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more