Struct AnyError

pub struct AnyError(/* private fields */);

Type-erased error that can wrap a StackError or any std::error::Error.

StackErrors have a blanket impl to convert into AnyError, while preserving their call-site location info.

Errors that implement std::error::Error but not StackError can’t convert to AnyError automatically. Use either AnyError::from_std or crate::StdResultExt::e to convert std errors into AnyError.

This is necessary unfortunately because if we had a blanket conversion from std errors to AnyError, this blanket conversion would also apply to StackErrors, thus losing their call-site location info in the conversion.

Implementations

impl AnyError

pub fn from_std(err: impl Error + Send + Sync + 'static) -> Self

Creates an AnyError from a std error.

This captures call-site metadata.

pub fn from_anyhow(err: Error) -> Self

Creates an AnyError from a anyhow::Error.

pub fn from_std_box(err: Box<dyn Error + Send + Sync + 'static>) -> Self

Creates an AnyError from a bosed std error.

This captures call-site metadata.

pub fn from_display(s: impl Display) -> Self

Creates an AnyError from any Display value by formatting it into a message.

pub fn from_string(message: String) -> Self

Creates an AnyError from a message string.

pub fn from_stack(err: impl StackError + 'static) -> Self

Creates an AnyError from a StackError.

This preserves the error’s call-site metadata.

Equivalent to AnyError::from(err).

pub fn from_stack_box(err: Box<dyn StackError>) -> Self

Creates an AnyError from a boxed StackError.

pub fn context(self, context: impl Display) -> AnyError

Adds additional context on top of this error.

pub fn into_boxed_dyn_error(self) -> Box<dyn Error + Send + Sync + 'static>

Converts into boxed std error.

Trait Implementations

impl Debug for AnyError

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

Formats the value using the given formatter.

impl Display for AnyError

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

Formats the value using the given formatter.

impl Error for AnyError

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<&str> for AnyError

fn from(value: &str) -> Self

Converts to this type from the input type.

impl From<Box<dyn Error + Sync + Send>> for AnyError

fn from(value: Box<dyn Error + Send + Sync>) -> Self

Converts to this type from the input type.

impl From<Error> for AnyError

fn from(value: Error) -> Self

Converts to this type from the input type.

impl From<String> for AnyError

fn from(value: String) -> Self

Converts to this type from the input type.

impl FromStr for AnyError

type Err = Infallible

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl StackError for AnyError

fn as_dyn(&self) -> &dyn StackError

Returns this error as a dyn StackError.

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

Returns this error as a std error reference.

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 is_transparent(&self) -> bool

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

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

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.