Trait StackError

pub trait StackError:
    Display
    + Debug
    + Send
    + Sync {
    // Required methods
    fn as_std(&self) -> &(dyn Error + Send + Sync + 'static);
    fn as_dyn(&self) -> &dyn StackError;
    fn meta(&self) -> Option<&Meta>;
    fn source(&self) -> Option<ErrorRef<'_>>;
    fn fmt_message(&self, f: &mut Formatter<'_>) -> Result;
    fn is_transparent(&self) -> bool;

    // Provided methods
    fn as_ref(&self) -> ErrorRef<'_> { ... }
    fn stack(&self) -> Chain<'_>  { ... }
    fn sources(&self) -> Chain<'_>  { ... }
    fn report(&self) -> Report<'_> { ... }
}

Trait implemented by errors produced by this crate.

It extends std::error::Error semantics with optional error metadata, and a source method where sources may also provide metadata.

Required Methods

fn as_std(&self) -> &(dyn Error + Send + Sync + 'static)

Returns this error as a std error reference.

fn as_dyn(&self) -> &dyn StackError

Returns this error as a dyn StackError.

fn meta(&self) -> Option<&Meta>

Returns metadata captured at creation time, if available.

fn source(&self) -> Option<ErrorRef<'_>>

Returns the next source in the chain, if any.

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

Returns the next source in the chain, if any.

fn is_transparent(&self) -> bool

Returns whether this error is transparent and should be skipped in reports.

Provided Methods

fn as_ref(&self) -> ErrorRef<'_>

Returns this error as an ErrorRef.

See ErrorRef for details.

fn stack(&self) -> Chain<'_>

Returns an iterator over this error followed by its sources.

fn sources(&self) -> Chain<'_>

Returns an iterator over sources of this error (skipping self).

fn report(&self) -> Report<'_>

Returns a Report to output the error with configurable formatting.

Trait Implementations

impl StackError for Box<dyn StackError>

fn as_std(&self) -> &(dyn Error + Send + Sync + 'static)

Returns this error as a std error reference.

fn as_dyn(&self) -> &dyn StackError

Returns this error as a dyn StackError.

fn meta(&self) -> Option<&Meta>

Returns metadata captured at creation time, if available.

fn source(&self) -> Option<ErrorRef<'_>>

Returns the next source in the chain, if any.

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

Returns the next source in the chain, if any.

fn is_transparent(&self) -> bool

Returns whether this error is transparent and should be skipped in reports.

fn as_ref(&self) -> ErrorRef<'_>

Returns this error as an ErrorRef.

fn stack(&self) -> Chain<'_>

Returns an iterator over this error followed by its sources.

fn sources(&self) -> Chain<'_>

Returns an iterator over sources of this error (skipping self).

fn report(&self) -> Report<'_>

Returns a Report to output the error with configurable formatting.

Implementations on Foreign Types

impl StackError for Box<dyn StackError>

fn as_std(&self) -> &(dyn Error + Send + Sync + 'static)

fn as_dyn(&self) -> &dyn StackError

fn meta(&self) -> Option<&Meta>

fn source(&self) -> Option<ErrorRef<'_>>

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

fn is_transparent(&self) -> bool

impl StackError for FromUtf8Error

fn as_std(&self) -> &(dyn Error + Send + Sync + 'static)

fn as_dyn(&self) -> &dyn StackError

fn meta(&self) -> Option<&Meta>

fn source(&self) -> Option<ErrorRef<'_>>

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

fn is_transparent(&self) -> bool

impl StackError for Arc<dyn StackError>

fn as_std(&self) -> &(dyn Error + Send + Sync + 'static)

fn as_dyn(&self) -> &dyn StackError

fn meta(&self) -> Option<&Meta>

fn source(&self) -> Option<ErrorRef<'_>>

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

fn is_transparent(&self) -> bool

impl StackError for TryFromSliceError

fn as_std(&self) -> &(dyn Error + Send + Sync + 'static)

fn as_dyn(&self) -> &dyn StackError

fn meta(&self) -> Option<&Meta>

fn source(&self) -> Option<ErrorRef<'_>>

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

fn is_transparent(&self) -> bool

impl StackError for Error

fn as_std(&self) -> &(dyn Error + Send + Sync + 'static)

fn as_dyn(&self) -> &dyn StackError

fn meta(&self) -> Option<&Meta>

fn source(&self) -> Option<ErrorRef<'_>>

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

fn is_transparent(&self) -> bool

impl StackError for AddrParseError

fn as_std(&self) -> &(dyn Error + Send + Sync + 'static)

fn as_dyn(&self) -> &dyn StackError

fn meta(&self) -> Option<&Meta>

fn source(&self) -> Option<ErrorRef<'_>>

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

fn is_transparent(&self) -> bool

impl StackError for Utf8Error

fn as_std(&self) -> &(dyn Error + Send + Sync + 'static)

fn as_dyn(&self) -> &dyn StackError

fn meta(&self) -> Option<&Meta>

fn source(&self) -> Option<ErrorRef<'_>>

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

fn is_transparent(&self) -> bool

impl StackError for Error

fn as_std(&self) -> &(dyn Error + Send + Sync + 'static)

fn as_dyn(&self) -> &dyn StackError

fn meta(&self) -> Option<&Meta>

fn source(&self) -> Option<ErrorRef<'_>>

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

fn is_transparent(&self) -> bool

Implementors

impl StackError for AnyError

impl StackError for NoneError