Struct EmailAddress 

#[non_exhaustive]
pub struct EmailAddress {
    pub name: Option<String>,
    pub address: Option<String>,
}

A single RFC 5322 mailbox parsed from an address-list.

Mirrors the JMAP EmailAddress object defined in RFC 8621 §4.1.2.3.

name is the optional display name. address is the addr-spec. Both are populated best-effort; either may be None if the original header is malformed.

Equality semantics

The derived PartialEq/Eq/Hash is byte-exact on both fields. In particular, address comparison is case-sensitive across the entire addr-spec, even though RFC 5321 §2.4 defines the domain part of an addr-spec as case-insensitive — so alice@example.com and alice@EXAMPLE.COM compare as not equal and hash differently. Callers that need RFC-5321-conformant equality (HashSet dedup of recipient lists, etc.) MUST canonicalise the domain part themselves before comparing or hashing.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

name: Option<String>

Display name from the mailbox, RFC 2047 encoded-words already decoded.

Parser-produced values are RFC 8621 §4.1.2.3 normalised: surrounding ASCII whitespace is trimmed from the decoded display name. A name that is empty after trimming is mapped to None (a lone empty quoted-string never surfaces as Some(String::new())).

address: Option<String>

addr-spec of the mailbox.

Implementations

impl EmailAddress

pub fn new(name: Option<String>, address: Option<String>) -> Self

Construct an EmailAddress from optional display name and addr-spec.

EmailAddress is #[non_exhaustive] so external callers cannot use struct expression syntax. Use this constructor — or Default::default() followed by field assignment — instead.

pub fn is_addressable(&self) -> bool

Whether this EmailAddress carries an addr-spec.

parse_header_typed produces EmailAddress values with address == None for malformed mailboxes (most commonly, display-name-only mailboxes from non-spec-conformant clients — e.g. a draft saved with just a typed-but-incomplete To:). Such entries are unusable for sending mail, address comparison, or addr-spec-keyed lookup.

Use this helper to filter parsed address lists down to the usable subset:

use mime_tree::EmailAddress;

let parsed = vec![
    EmailAddress::new(
        Some("Alice".to_owned()),
        Some("alice@example.com".to_owned()),
    ),
    EmailAddress::new(Some("Display-Name Only".to_owned()), None),
];
let usable: Vec<EmailAddress> = parsed
    .into_iter()
    .filter(EmailAddress::is_addressable)
    .collect();
assert_eq!(usable.len(), 1);
assert_eq!(usable[0].address.as_deref(), Some("alice@example.com"));

Trait Implementations

impl Clone for EmailAddress

fn clone(&self) -> EmailAddress

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EmailAddress

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

Formats the value using the given formatter.

impl Default for EmailAddress

fn default() -> EmailAddress

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for EmailAddress

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for EmailAddress

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

Render in RFC 5322 §3.4 mailbox-ish form.

• Both name and address present: Display Name <addr@host>.
• address only: addr@host (bare addr-spec, no angle brackets).
• name only: Display Name (degenerate; not a valid RFC 5322 mailbox, but the best a Display impl can do).
• Neither present: the empty string.

Names are emitted verbatim. This Display impl prioritises human readability over RFC 5322 round-trippability — names containing <, >, ,, or other RFC 5322 specials are not quoted. Callers that need byte-stable round-trip into a header field MUST roll their own serializer with proper quoting.

impl Eq for EmailAddress

impl Hash for EmailAddress

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

Feeds this value into the given Hasher.

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

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for EmailAddress

fn eq(&self, other: &EmailAddress) -> 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 Serialize for EmailAddress

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for EmailAddress