Struct failure::Context

pub struct Context<D: Display + Send + Sync + 'static> { /* private fields */ }

An error with context around it.

The context is intended to be a human-readable, user-facing explanation for the error that has occurred. The underlying error is not assumed to be end-user-relevant information.

The Display impl for Context only prints the human-readable context, while the Debug impl also prints the underlying error.

Implementations

impl<D: Display + Send + Sync + 'static> Context<D>

pub fn new(context: D) -> Context<D>

Creates a new context without an underlying error message.

pub fn get_context(&self) -> &D

Returns a reference to the context provided with this error.

pub fn map<F, T>(self, op: F) -> Context<T> where
    F: FnOnce(D) -> T,
    T: Display + Send + Sync + 'static, 

Maps Context<D> to Context<T> by applying a function to the contained context.

Trait Implementations

impl<D: Display + Send + Sync + 'static> Debug for Context<D>

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

Formats the value using the given formatter.

impl<D: Display + Send + Sync + 'static> Display for Context<D>

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

Formats the value using the given formatter.

impl<D: Display + Send + Sync + 'static> Fail for Context<D>

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

Returns the “name” of the error.

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

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 context<D>(self, context: D) -> Context<D> where
    D: Display + Send + Sync + 'static,
    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<D> From<D> for Context<D> where
    D: Display + Send + Sync + 'static, 

fn from(display: D) -> Context<D>

Performs the conversion.