Struct mail::error::ComponentCreationError

pub struct ComponentCreationError { /* private fields */ }

Creating a (header field) component from the given data failed

A good example converting a string to a mailbox by parsing it, or more concretely failing to do so because it’s not a valid mail address.

Implementations

impl ComponentCreationError

pub fn from_parent<P>(
    parent: P,
    component: &'static str
) -> ComponentCreationErrorwhere
    P: Into<Error>,

create a new ComponentCreationError based on a different error and the name of the component

The name is normally the type name, for example Email, Mailbox etc.

pub fn new(component: &'static str) -> ComponentCreationError

creates a new ComponentCreationError based on the components name

The name is normally the type name, for example Email, Mailbox etc.

pub fn new_with_str<I>(
    component: &'static str,
    str_context: I
) -> ComponentCreationErrorwhere
    I: Into<String>,

creates a new ComponentCreationError based on the components name with a str_context

The name is normally the type name, for example Email, Mailbox etc.

The str_context is a snipped of text which can help a human to identify the invalid parts, e.g. for parsing a email it could be the invalid email address.

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

pub fn set_str_context<I>(&mut self, ctx: I)where
    I: Into<String>,

pub fn with_str_context<I>(self, ctx: I) -> ComponentCreationErrorwhere
    I: Into<String>,

Trait Implementations

impl Debug for ComponentCreationError

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

Formats the value using the given formatter.

impl Display for ComponentCreationError

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

Formats the value using the given formatter.

impl Fail for ComponentCreationError

fn cause(&self) -> Option<&(dyn Fail + 'static)>

Returns a reference to the underlying cause of this failure, if it is an error that wraps other errors.

fn backtrace(&self) -> Option<&Backtrace>

Returns a reference to the Backtrace carried by this failure, if it carries one.

fn name(&self) -> Option<&str>

Returns the “name” of the error.

fn context<D>(self, context: D) -> Context<D>where
    D: 'static + Display + Send + Sync,
    Self: Sized,

Provides context for this failure.

fn compat(self) -> Compat<Self>where
    Self: Sized,

Wraps this failure in a compatibility wrapper that implements std::error::Error.

impl From<ComponentCreationError> for MailError

fn from(err: ComponentCreationError) -> MailError

Converts to this type from the input type.