Struct Context

pub struct Context<M, E> { /* private fields */ }

Additional level of context, wrapping some error inside itself.

This is produced by the context and implements the additional (outer) layer in the chain. Any number of contexts can be chained together.

Implementations

impl<M, E> Context<M, E>

pub fn new(msg: M, error: E) -> Self

A direct constructor for the context.

More usually created by the context, but allowing for construction directly without importing the trait.

pub fn into_inner(self) -> E

Extracts the inner error, peeling off the outer layer.

impl<M> Context<M, Compat<Error>>

pub fn from_failure(msg: M, failure: Error) -> Self

Constructor of context from a failure’s Error.

This is a compatibility constructor, for wrapping the error of failure. It is enabled by the failure feature.

Warning

The compatibility layer has no way to access the original causes of the failure. Therefore, the inner layers of the provided failure will be lost and the failure will be considered the innermost level.

impl<M, F: Fail> Context<M, Compat<F>>

pub fn from_fail(msg: M, failure: F) -> Self

Constructor of context from a failure’s Fail.

This is a compatibility constructor, for wrapping failure. It is enabled by the failure feature.

Warning

The compatibility layer has no way to access the original causes of the failure. Therefore, the inner layers of the provided failure will be lost and the failure will be considered the innermost level.

Trait Implementations

impl<M: Clone, E: Clone> Clone for Context<M, E>

fn clone(&self) -> Context<M, E>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<M: Debug, E: Debug> Debug for Context<M, E>

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

Formats the value using the given formatter.

impl<M: Display, E> Display for Context<M, E>

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

Formats the value using the given formatter.

impl<M: Debug + Display, E: Error + 'static> Error for Context<M, E>

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

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

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl<M: Copy, E: Copy> Copy for Context<M, E>