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>()?;
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

The value is not enclosed in angle brackets.

ContainsWhitespace

The value contains whitespace.

MissingLocal

The value has no local part before @.

MissingDomain

The value has no domain after @.

#[non_exhaustive]

InvalidContent

The local part or domain violates the supported addr-spec grammar.

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

The underlying addr-spec validation error.

ObsoleteIdLeftForm

The id-left uses the unsupported obsolete quoted-string form.

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 Eq for MessageIdParseError

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

Equality operator ==.

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

Inequality operator !=.