Struct BoxedStackError 

pub struct BoxedStackError { /* private fields */ }

Type-erased wrapper around Box<dyn StackError + Send + Sync>.

Provides uniform handling of heterogeneous StackError types while preserving location tracking through the error chain. Use this instead of Box<dyn StackError + Send + Sync> for shorter type signatures and automatic From generation by the derive macro.

Note: downcasting to the concrete type is not supported through this wrapper. Use into_inner() if you need the raw trait object.

Clone is not implemented because the inner trait object (Box<dyn StackError + Send + Sync>) cannot be cloned.

Example

use suzunari_error::*;

#[suzunari_error]
#[suzu(display("inner error"))]
struct InnerError {}

#[suzunari_error]
#[suzu(display("outer error"))]
struct OuterError {
    source: BoxedStackError,
}

fn inner() -> Result<(), InnerError> {
    ensure!(false, InnerSnafu);
    Ok(())
}

fn outer() -> Result<(), OuterError> {
    inner()
        .map_err(BoxedStackError::new)
        .context(OuterSnafu)?;
    Ok(())
}

let err = outer().unwrap_err();
assert_eq!(err.type_name(), "OuterError");
assert!(err.stack_source().is_some());

Implementations

impl BoxedStackError

pub fn new<T: StackError + Send + Sync + 'static>(inner: T) -> Self

Wraps a concrete StackError in a type-erased box.

pub fn inner(&self) -> &(dyn StackError + Send + Sync)

Returns a reference to the inner trait object.

pub fn into_inner(self) -> Box<dyn StackError + Send + Sync>

Unwraps into the inner trait object.

Trait Implementations

impl Debug for BoxedStackError

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

Formats the value using the given formatter.

impl Display for BoxedStackError

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

Formats the value using the given formatter.

impl Error for BoxedStackError

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 From<Box<dyn StackError + Sync + Send>> for BoxedStackError

fn from(inner: Box<dyn StackError + Send + Sync>) -> Self

Converts to this type from the input type.

impl From<BoxedStackError> for Box<dyn StackError + Send + Sync>

fn from(inner: BoxedStackError) -> Self

Converts to this type from the input type.

impl StackError for BoxedStackError

fn location(&self) -> Location

Returns the location where this error was constructed.

fn type_name(&self) -> &'static str

Returns a human-readable type name for display in stack traces.

fn stack_source(&self) -> Option<&dyn StackError>

Returns the source error as a StackError, if available.

fn depth(&self) -> usize

Returns the number of errors in the Error::source() chain (excluding self).