Struct ListenerError 

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

Opaque error returned by an event listener.

ListenerError is the typed wrapper the dispatcher stores in crate::DispatchResult for every failing listener. It hides the concrete error type a listener returned, while still letting callers inspect the chain via std::error::Error::source.

Constructing

use mod_events::ListenerError;
use std::io;

// From any Error + Send + Sync + 'static
let from_err = ListenerError::new(io::Error::new(io::ErrorKind::Other, "bad"));

// From a string literal or owned String, via Into
let from_str: ListenerError = "validation failed".into();
let from_string: ListenerError = format!("retry budget exhausted").into();

Implementations

impl ListenerError

pub fn new<E>(error: E) -> Self

where E: Error + Send + Sync + 'static,

Wrap any error value that implements Error + Send + Sync + 'static.

pub fn message<S: Into<String>>(msg: S) -> Self

Wrap a textual message as a listener error.

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

Borrow the underlying error trait object.

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

Consume the wrapper and return the inner boxed error.

Trait Implementations

impl Debug for ListenerError

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

Formats the value using the given formatter.

impl Display for ListenerError

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

Formats the value using the given formatter.

impl Error for ListenerError

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 ListenerError

fn from(s: &str) -> Self

Converts to this type from the input type.

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

fn from(boxed: Box<dyn Error + Send + Sync + 'static>) -> Self

Converts to this type from the input type.

impl From<String> for ListenerError

fn from(s: String) -> Self

Converts to this type from the input type.