Struct Message

pub struct Message<'x> {
    pub html_body: Vec<MessagePartId>,
    pub text_body: Vec<MessagePartId>,
    pub attachments: Vec<MessagePartId>,
    pub parts: Vec<MessagePart<'x>>,
    pub raw_message: Cow<'x, [u8]>,
}

An RFC5322/RFC822 message.

Fields

html_body: Vec<MessagePartId>

text_body: Vec<MessagePartId>

attachments: Vec<MessagePartId>

parts: Vec<MessagePart<'x>>

raw_message: Cow<'x, [u8]>

Implementations

impl<'x> Message<'x>

pub fn root_part(&self) -> &MessagePart<'x>

Returns the root message part

pub fn header( &self, header: impl Into<HeaderName<'x>>, ) -> Option<&HeaderValue<'x>>

Returns a parsed header.

pub fn remove_header( &mut self, header: impl Into<HeaderName<'x>>, ) -> Option<HeaderValue<'x>>

Removed a parsed header and returns its value.

pub fn header_raw(&self, header: impl Into<HeaderName<'x>>) -> Option<&str>

Returns the raw header.

pub fn header_as( &self, header: impl Into<HeaderName<'x>>, form: HeaderForm, ) -> Vec<HeaderValue<'_>>

pub fn headers(&self) -> &[Header<'x>]

Returns an iterator over the RFC headers of this message.

pub fn header_values( &self, name: impl Into<HeaderName<'x>>, ) -> impl Iterator<Item = &HeaderValue<'x>> + Sync + Send

Returns an iterator over the matching RFC headers of this message.

pub fn headers_raw(&self) -> impl Iterator<Item = (&str, &str)> + Sync + Send

Returns all headers in raw format

pub fn raw_message(&self) -> &[u8]

Returns the raw message

pub fn bcc(&self) -> Option<&Address<'x>>

Returns the BCC header field

pub fn cc(&self) -> Option<&Address<'x>>

Returns the CC header field

pub fn comments(&self) -> &HeaderValue<'x>

Returns all Comments header fields

pub fn date(&self) -> Option<&DateTime>

Returns the Date header field

pub fn from(&self) -> Option<&Address<'x>>

Returns the From header field

pub fn in_reply_to(&self) -> &HeaderValue<'x>

Returns all In-Reply-To header fields

pub fn keywords(&self) -> &HeaderValue<'x>

Returns all Keywords header fields

pub fn list_archive(&self) -> &HeaderValue<'x>

Returns the List-Archive header field

pub fn list_help(&self) -> &HeaderValue<'x>

Returns the List-Help header field

pub fn list_id(&self) -> &HeaderValue<'x>

Returns the List-ID header field

pub fn list_owner(&self) -> &HeaderValue<'x>

Returns the List-Owner header field

pub fn list_post(&self) -> &HeaderValue<'x>

Returns the List-Post header field

pub fn list_subscribe(&self) -> &HeaderValue<'x>

Returns the List-Subscribe header field

pub fn list_unsubscribe(&self) -> &HeaderValue<'x>

Returns the List-Unsubscribe header field

pub fn message_id(&self) -> Option<&str>

Returns the Message-ID header field

pub fn mime_version(&self) -> &HeaderValue<'x>

Returns the MIME-Version header field

pub fn received(&self) -> Option<&Received<'x>>

Returns the first Received header field

pub fn references(&self) -> &HeaderValue<'x>

Returns all References header fields

pub fn reply_to(&self) -> Option<&Address<'x>>

Returns the Reply-To header field

pub fn resent_bcc(&self) -> Option<&Address<'x>>

Returns the Resent-BCC header field

pub fn resent_cc(&self) -> Option<&Address<'x>>

Returns the Resent-CC header field

pub fn resent_date(&self) -> &HeaderValue<'x>

Returns all Resent-Date header fields

pub fn resent_from(&self) -> Option<&Address<'x>>

Returns the Resent-From header field

pub fn resent_message_id(&self) -> &HeaderValue<'x>

Returns all Resent-Message-ID header fields

pub fn resent_sender(&self) -> Option<&Address<'x>>

Returns the Sender header field

pub fn resent_to(&self) -> Option<&Address<'x>>

Returns the Resent-To header field

pub fn return_path(&self) -> &HeaderValue<'x>

Returns all Return-Path header fields

pub fn return_address(&self) -> Option<&str>

Returns the return address from either the Return-Path or From header fields

pub fn sender(&self) -> Option<&Address<'x>>

Returns the Sender header field

pub fn subject(&self) -> Option<&str>

Returns the Subject header field

pub fn thread_name(&self) -> Option<&str>

Returns the message thread name or ‘base subject’ as defined in RFC 5957 - Internet Message Access Protocol - SORT and THREAD Extensions (Section 2.1)

pub fn to(&self) -> Option<&Address<'x>>

Returns the To header field

pub fn body_preview(&self, preview_len: usize) -> Option<Cow<'x, str>>

Returns a preview of the message body

pub fn body_html(&'x self, pos: usize) -> Option<Cow<'x, str>>

Returns a message body part as text/plain

pub fn body_text(&'x self, pos: usize) -> Option<Cow<'x, str>>

Returns a message body part as text/plain

pub fn part(&self, pos: u32) -> Option<&MessagePart<'x>>

Returns a message part by position

pub fn html_part(&self, pos: u32) -> Option<&MessagePart<'x>>

Returns an inline HTML body part by position

pub fn text_part(&self, pos: u32) -> Option<&MessagePart<'x>>

Returns an inline text body part by position

pub fn attachment(&self, pos: u32) -> Option<&MessagePart<'x>>

Returns an attacment by position

pub fn text_body_count(&self) -> usize

Returns the number of plain text body parts

pub fn html_body_count(&self) -> usize

Returns the number of HTML body parts

pub fn attachment_count(&self) -> usize

Returns the number of attachments

pub fn text_bodies( &self, ) -> impl Iterator<Item = &MessagePart<'_>> + Sync + Send

Returns an Interator over the text body parts

pub fn html_bodies( &self, ) -> impl Iterator<Item = &MessagePart<'_>> + Sync + Send

Returns an Interator over the HTML body parts

pub fn attachments( &self, ) -> impl Iterator<Item = &MessagePart<'_>> + Sync + Send

Returns an Interator over the attachments

pub fn into_owned(self) -> Message<'static>

Returns an owned version of the message

impl<'x> Message<'x>

pub fn is_empty(&self) -> bool

Returns false if at least one header field was successfully parsed.

Trait Implementations

impl<'x> Clone for Message<'x>

fn clone(&self) -> Message<'x>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'x> Debug for Message<'x>

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

Formats the value using the given formatter.

impl<'x> Default for Message<'x>

fn default() -> Message<'x>

Returns the “default value” for a type.

impl<'x> MimeHeaders<'x> for Message<'x>

fn content_description(&self) -> Option<&str>

Returns the Content-Description field

fn content_disposition(&self) -> Option<&ContentType<'x>>

Returns the Content-Disposition field

fn content_id(&self) -> Option<&str>

Returns the Content-ID field

fn content_transfer_encoding(&self) -> Option<&str>

Returns the Content-Encoding field

fn content_type(&self) -> Option<&ContentType<'x>>

Returns the Content-Type field

fn content_language(&self) -> &HeaderValue<'x>

Returns the Content-Language field

fn content_location(&self) -> Option<&str>

Returns the Content-Location field

fn attachment_name(&self) -> Option<&str>

Returns the attachment name, if any.

fn is_content_type(&self, type_: &str, subtype: &str) -> bool

impl<'x> PartialEq for Message<'x>

fn eq(&self, other: &Message<'x>) -> 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<'x> TryInto<Message<'x>> for &'x [u8]

type Error = ()

The type returned in the event of a conversion error.

fn try_into(self) -> Result<Message<'x>, Self::Error>

Performs the conversion.

impl<'x> StructuralPartialEq for Message<'x>