Struct new_tokio_smtp::send_mail::MailAddress

pub struct MailAddress { /* private fields */ }

A simple MailAddress type

In difference to ForwardPath and ReversePath this is only a mail address and no other “path” parts. Which is how the paths are mostly used today anyway.

This type also keeps track of wether or not SMTPUTF8 is required.

Temporary Limitations

Currently this type doesn’t has a mail address parser, once I find a good crate for this it will be included. I.e. currently you have to make sure you mail is valid and then use from_unchecked to crate a MailAddress, this will also check if it’s an internationalized mail address as it can do so without needing to check the grammar.

Implementations

impl MailAddress

pub fn new_unchecked(raw_email: String, needs_smtputf8: bool) -> Self

create a new MailAddress from parts

this methods relies on the given values to be correct if the raw_mail is actually an internationalized mail address but needs_smtputf8 is false this can lead to problems up to a disconnection of the server (especially if it’s an old one)

pub fn from_unchecked<I>(raw: I) -> Selfwhere
    I: Into<String> + AsRef<str>,

create a mail from a string not checking syntactical validity

(through it does check if it’s an internationalized mail address)

pub fn needs_smtputf8(&self) -> bool

pub fn as_str(&self) -> &str

Trait Implementations

impl AsRef<str> for MailAddress

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for MailAddress

fn clone(&self) -> MailAddress

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for MailAddress

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

Formats the value using the given formatter.

impl From<MailAddress> for ForwardPath

fn from(addr: MailAddress) -> ForwardPath

Converts to this type from the input type.

impl From<MailAddress> for ReversePath

fn from(addr: MailAddress) -> ReversePath

Converts to this type from the input type.

impl Into<String> for MailAddress

fn into(self) -> String

Converts this type into the (usually inferred) input type.