Enum MessageIdParseError 

#[non_exhaustive]
pub enum MessageIdParseError {
    MissingBrackets,
    ContainsWhitespace,
    MissingLocal,
    MissingDomain,
    #[non_exhaustive]
    InvalidContent {
        source: EmailAddressParseError,
    },
    ObsoleteIdLeftForm,
}

Reasons a string cannot be parsed as an RFC 5322 Message-ID.

use email_message::{MessageId, MessageIdParseError};

// Brackets are mandatory.
assert_eq!(
    "abc@example.com".parse::<MessageId>().unwrap_err(),
    MessageIdParseError::MissingBrackets,
);

// Local part validates against the addr-spec dot-atom grammar:
// a leading dot is illegal.
assert!(matches!(
    "<.bad@example.com>".parse::<MessageId>().unwrap_err(),
    MessageIdParseError::InvalidContent { .. },
));

// A well-formed Message-ID round-trips its bracketed form.
let parsed = "<good@example.com>".parse::<MessageId>().unwrap();
assert_eq!(parsed.as_str(), "<good@example.com>");

Variants (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.

MissingBrackets

ContainsWhitespace

MissingLocal

MissingDomain

#[non_exhaustive]

InvalidContent

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

source: EmailAddressParseError

ObsoleteIdLeftForm

Trait Implementations

impl Debug for MessageIdParseError

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

Formats the value using the given formatter.

impl Display for MessageIdParseError

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

Formats the value using the given formatter.

impl Error for MessageIdParseError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl PartialEq for MessageIdParseError

fn eq(&self, other: &Self) -> 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 Eq for MessageIdParseError