Struct ErrorRegistry 

pub struct ErrorRegistry { /* private fields */ }

A synchronized, type-checked registry for a single error value.

Under std, stored errors are owned by a Mutex and retrieved using a checked core::any::Any downcast. A request for a different type returns None. Under no_std, where this crate has no synchronization primitive capable of owning an arbitrary allocation, the registry records only whether an error occurred.

Implementations

impl ErrorRegistry

pub const fn new() -> Self

Create a new, empty error registry.

pub fn store<E>(&self, error: E)

where E: Send + 'static,

Store an error in the registry, replacing the previous value.

Errors must be owned and safe to move between threads because the registry is process-global. The replaced value is dropped after the registry lock is released so user-defined destructors cannot deadlock the registry by re-entering it.

pub fn clear(&self)

Clear and drop the stored error, if any.

pub fn has_error(&self) -> bool

Check whether an error is currently present.

pub fn get_error<E>(&self) -> Option<E>

where E: Clone + Send + 'static,

Clone the stored error if its concrete type is exactly E.

A type mismatch returns None; callers can never reinterpret the allocation as another type.

Trait Implementations

impl Default for ErrorRegistry

fn default() -> Self

Returns the “default value” for a type.

impl Drop for ErrorRegistry

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

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

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.