Struct AddressList 

pub struct AddressList<'m> { /* private fields */ }

An address list: mailboxes and groups in document order (issue #98). Lists compare by content.

use mail_parser::{Address, MessageParser};

let raw = b"To: Ann <ann@example.com>, team: bob@example.com, cy@example.com;\r\n\r\n";
let message = MessageParser::new().parse(raw).expect("message");
let to = message.to().expect("addresses");
let addresses: Vec<_> = to.mailboxes().filter_map(|mailbox| mailbox.address()).collect();
assert_eq!(addresses, ["ann@example.com", "bob@example.com", "cy@example.com"]);
assert!(matches!(to.iter().nth(1), Some(Address::Group(group)) if group.name() == Some("team")));
assert!(to.contains("BOB@example.com"));

Implementations

impl<'m> AddressList<'m>

pub fn is_empty(&self) -> bool

Whether the list has neither mailboxes nor groups.

pub fn iter(&self) -> impl Iterator<Item = Address<'m>> + use<'m>

Mailboxes and groups in document order.

pub fn mailboxes( &self, ) -> impl DoubleEndedIterator<Item = Mailbox<'m>> + use<'m>

Every mailbox, groups flattened.

pub fn first(&self) -> Option<Mailbox<'m>>

The first mailbox, groups flattened.

pub fn last(&self) -> Option<Mailbox<'m>>

The last mailbox, groups flattened.

pub fn groups( &self, ) -> impl Iterator<Item = (Option<&'m str>, AddressRun<'m>)> + use<'m>

The JMAP asGroupedAddresses shape (RFC 8621): each group with its name, and each run of mailboxes outside groups as an unnamed group.

pub fn contains(&self, address: &str) -> bool

Whether any mailbox has this address (ASCII case-insensitive).

pub fn has_groups(&self) -> bool

Whether the list contains at least one group.

Trait Implementations

impl<'m> Clone for AddressList<'m>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'m> Copy for AddressList<'m>

impl Debug for AddressList<'_>

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

Formats the value using the given formatter.

impl Eq for AddressList<'_>

impl PartialEq for AddressList<'_>

fn eq(&self, other: &Self) -> bool

Equality operator ==.

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

Inequality operator !=.