pub enum MessageDataItem<'a> {
    Body(BodyStructure<'a>),
    BodyExt {
        section: Option<Section<'a>>,
        origin: Option<u32>,
        data: NString<'a>,
    },
    BodyStructure(BodyStructure<'a>),
    Envelope(Envelope<'a>),
    Flags(Vec<FlagFetch<'a>, Global>),
    InternalDate(DateTime),
    Rfc822(NString<'a>),
    Rfc822Header(NString<'a>),
    Rfc822Size(u32),
    Rfc822Text(NString<'a>),
    Uid(NonZeroU32),
}
Expand description

Message data item.

Variants§

§

Body(BodyStructure<'a>)

A form of BODYSTRUCTURE without extension data.

BODY
§

BodyExt

Fields

§section: Option<Section<'a>>

The specified section.

§origin: Option<u32>

If the origin octet is specified, this string is a substring of the entire body contents, starting at that origin octet. This means that BODY[]<0> MAY be truncated, but BODY[] is NEVER truncated.

Note: The origin octet facility MUST NOT be used by a server in a FETCH response unless the client specifically requested it by means of a FETCH of a BODY[<section>]<<partial>> data item.

§data: NString<'a>

The string SHOULD be interpreted by the client according to the content transfer encoding, body type, and subtype.

The body contents of the specified section.

8-bit textual data is permitted if a [CHARSET] identifier is part of the body parameter parenthesized list for this section. Note that headers (part specifiers HEADER or MIME, or the header portion of a MESSAGE/RFC822 part), MUST be 7-bit; 8-bit characters are not permitted in headers. Note also that the [RFC-2822] delimiting blank line between the header and the body is not affected by header line subsetting; the blank line is always included as part of header data, except in the case of a message which has no body and no blank line.

Non-textual data such as binary data MUST be transfer encoded into a textual form, such as BASE64, prior to being sent to the client. To derive the original binary data, the client MUST decode the transfer encoded string.

BODY[<section>]<<origin octet>>
§

BodyStructure(BodyStructure<'a>)

The [MIME-IMB] body structure of a message.

This is computed by the server by parsing the [MIME-IMB] header fields, defaulting various fields as necessary.

BODYSTRUCTURE
§

Envelope(Envelope<'a>)

The envelope structure of a message.

This is computed by the server by parsing the [RFC-2822] header into the component parts, defaulting various fields as necessary.

ENVELOPE
§

Flags(Vec<FlagFetch<'a>, Global>)

A list of flags that are set for a message.

FLAGS
§

InternalDate(DateTime)

A string representing the internal date of a message.

INTERNALDATE
§

Rfc822(NString<'a>)

Equivalent to BODY[].

RFC822
§

Rfc822Header(NString<'a>)

Equivalent to BODY[HEADER].

Note that this did not result in \Seen being set, because RFC822.HEADER response data occurs as a result of a FETCH of RFC822.HEADER. BODY[HEADER] response data occurs as a result of a FETCH of BODY[HEADER] (which sets \Seen) or BODY.PEEK[HEADER] (which does not set \Seen).

RFC822.HEADER
§

Rfc822Size(u32)

A number expressing the [RFC-2822] size of a message.

RFC822.SIZE
§

Rfc822Text(NString<'a>)

Equivalent to BODY[TEXT].

RFC822.TEXT
§

Uid(NonZeroU32)

A number expressing the unique identifier of a message.

UID

Trait Implementations§

source§

impl<'a, 'arbitrary> Arbitrary<'arbitrary> for MessageDataItem<'a>where 'arbitrary: 'a,

source§

fn arbitrary( u: &mut Unstructured<'arbitrary> ) -> Result<MessageDataItem<'a>, Error>

Generate an arbitrary value of Self from the given unstructured data. Read more
source§

fn arbitrary_take_rest( u: Unstructured<'arbitrary> ) -> Result<MessageDataItem<'a>, Error>

Generate an arbitrary value of Self from the entirety of the given unstructured data. Read more
source§

fn size_hint(depth: usize) -> (usize, Option<usize>)

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself. Read more
source§

impl<'a> Clone for MessageDataItem<'a>

source§

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

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl<'a> Debug for MessageDataItem<'a>

source§

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

Formats the value using the given formatter. Read more
source§

impl<'de, 'a> Deserialize<'de> for MessageDataItem<'a>

source§

fn deserialize<__D>( __deserializer: __D ) -> Result<MessageDataItem<'a>, <__D as Deserializer<'de>>::Error>where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
source§

impl<'a> Hash for MessageDataItem<'a>

source§

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

Feeds this value into the given Hasher. Read more
1.3.0 · source§

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

Feeds a slice of this type into the given Hasher. Read more
source§

impl<'a> IntoBoundedStatic for MessageDataItem<'a>

§

type Static = MessageDataItem<'static>

The target type is bounded by the 'static lifetime.
source§

fn into_static(self) -> <MessageDataItem<'a> as IntoBoundedStatic>::Static

Convert an owned T into an owned T such that T: 'static.
source§

impl<'a> PartialEq<MessageDataItem<'a>> for MessageDataItem<'a>

source§

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

This method tests for self and other values to be equal, and is used by ==.
1.0.0 · source§

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl<'a> Serialize for MessageDataItem<'a>

source§

fn serialize<__S>( &self, __serializer: __S ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>where __S: Serializer,

Serialize this value into the given Serde serializer. Read more
source§

impl<'a> ToBoundedStatic for MessageDataItem<'a>

§

type Static = MessageDataItem<'static>

The target type is bounded by the 'static lifetime.
source§

fn to_static(&self) -> <MessageDataItem<'a> as ToBoundedStatic>::Static

Convert an &T to an owned T such that T: 'static.
source§

impl<'a> Eq for MessageDataItem<'a>

source§

impl<'a> StructuralEq for MessageDataItem<'a>

source§

impl<'a> StructuralPartialEq for MessageDataItem<'a>

Auto Trait Implementations§

§

impl<'a> RefUnwindSafe for MessageDataItem<'a>

§

impl<'a> Send for MessageDataItem<'a>

§

impl<'a> Sync for MessageDataItem<'a>

§

impl<'a> Unpin for MessageDataItem<'a>

§

impl<'a> UnwindSafe for MessageDataItem<'a>

Blanket Implementations§

source§

impl<T> Any for Twhere T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for Twhere T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for Twhere T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> Encode for Twhere T: Encoder,

source§

fn encode(&self) -> Encoded

Create an Encoded for this message.
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for Twhere U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> ToOwned for Twhere T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

impl<T> DeserializeOwned for Twhere T: for<'de> Deserialize<'de>,