Skip to main content

Error

Struct Error 

Source
pub struct Error<Kind> { /* private fields */ }
Expand description

A typed error wrapper carrying a Kind discriminant plus diagnostic metadata.

§no_alloc platforms

When compiled without the alloc feature, Error<Kind> retains kind, context, and location inline. The error source chain is unavailable. no_alloc targets are supported on a best-effort basis and are not a primary target of this crate. Do not add more inline fields here: the struct should stay lean for stack-constrained environments.

Implementations§

Source§

impl<Kind> Error<Kind>

Source

pub fn new(context: &'static str, kind: Kind) -> Self

Source

pub fn with_source<E>(self, source: E) -> Self
where E: Source,

Source

pub fn kind(&self) -> &Kind

Source

pub fn location(&self) -> &'static Location<'static>

Returns the source code location at which this error was constructed.

Captured automatically by Error::new via core::panic::Location::caller and #[track_caller]. Useful for diagnostic logging and error reporting when the variant alone does not narrow down the call site enough.

Source

pub fn set_context(&mut self, context: &'static str)

Source

pub fn report(&self) -> ErrorReport<'_, Kind>

Trait Implementations§

Source§

impl<Kind: Debug> Debug for Error<Kind>

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<Kind> Display for Error<Kind>
where Kind: Display,

Source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

§

impl<Kind> Freeze for Error<Kind>
where Kind: Freeze,

§

impl<Kind> RefUnwindSafe for Error<Kind>
where Kind: RefUnwindSafe,

§

impl<Kind> Send for Error<Kind>
where Kind: Send,

§

impl<Kind> Sync for Error<Kind>
where Kind: Sync,

§

impl<Kind> Unpin for Error<Kind>
where Kind: Unpin,

§

impl<Kind> UnsafeUnpin for Error<Kind>
where Kind: UnsafeUnpin,

§

impl<Kind> UnwindSafe for Error<Kind>
where Kind: UnwindSafe,

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.