Struct sequoia_rfc2822::AddrSpecOrOther

pub struct AddrSpecOrOther { /* fields omitted */ }

A parsed RFC 2822 addr-spec, which also recognizes invalid email addresses.

For this parser to recognize an email address, the input must not include angle brackets. That is, this parser recognizes addresses of the form:

email@example.org

But not:

<email@example.org>

When parsing valid email addresses, RFC 2822 comments are ignored.

If the input is not a valid email address, no error is returned by AddrSpecOrOther::parse() (unlike AddrSpec::parse()). Instead, the invalid email address can be obtained using AddrSpecOrOther::other(). Consider:

ssh://server.example.net

In this case, AddrSpecOrOther::other() returns ssh://server.example.net. The parse error can still be obtained using AddrSpecOrOther::address().

Methods

impl AddrSpecOrOther

pub fn parse<S>(input: S) -> Result<Self> where
    S: AsRef<str>, 

Parses a string that allegedly contains an RFC 2822 addr-spec or other.

pub fn address(&self) -> Result<&str>

Returns the address, if any.

If the address is invalid, then the parse error is returned.

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

Returns the invalid address, if any.

If the address is valid, then this returns None.

Trait Implementations

impl Eq for AddrSpecOrOther

impl Clone for AddrSpecOrOther

fn clone(&self) -> AddrSpecOrOther

Returns a copy of the value.

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

Performs copy-assignment from source.

impl PartialEq<AddrSpecOrOther> for AddrSpecOrOther

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl Debug for AddrSpecOrOther

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

Formats the value using the given formatter.