Struct Error

Source

pub struct Error { /* private fields */ }

Expand description

An error encountered when communicating with the service.

Implementations§

Source §

impl Error

Source

pub fn new<E>(kind: ErrorKind, error: E) -> Error
where E: Into<Box<dyn Error + Send + Sync>>,

Create a new Error based on an ErrorKind and an underlying error cause.

Source

pub fn with_error<E, C>(kind: ErrorKind, error: E, message: C) -> Error
where E: Into<Box<dyn Error + Send + Sync>>, C: Into<Cow<'static, str>>,

Create a new Error based on an ErrorKind, an underlying error cause, and a message.

Source

pub fn with_error_fn<E, F, C>(kind: ErrorKind, error: E, f: F) -> Error
where E: Into<Box<dyn Error + Send + Sync>>, F: FnOnce() -> C, C: Into<Cow<'static, str>>,

Create a new Error based on an ErrorKind, an underlying error cause, and a function that returns a message.

Source

pub fn with_message<C>(kind: ErrorKind, message: C) -> Error
where C: Into<Cow<'static, str>>,

Create an Error based on an ErrorKind and a message.

Source

pub fn with_message_fn<F, C>(kind: ErrorKind, f: F) -> Error
where F: FnOnce() -> C, C: Into<Cow<'static, str>>,

Creates an Error based on an ErrorKind and a function that returns a message.

Source

pub fn with_context<C>(self, message: C) -> Error
where C: Into<Cow<'static, str>>,

Wrap this error with an additional message.

Source

pub fn with_context_fn<F, C>(self, f: F) -> Error
where F: FnOnce() -> C, C: Into<Cow<'static, str>>,

Wrap this error with an additional message returned from a function.

Source

pub fn kind(&self) -> &ErrorKind

Get the ErrorKind of this Error.

Source

pub fn http_status(&self) -> Option<StatusCode>

Available on crate feature http only.

If this error is an HTTP response error, return the associated status code.

Source

pub fn into_inner(self) -> Result<Box<dyn Error + Send + Sync>, Error>

Consumes the Error, returning its inner error, if any.

Source

pub fn into_downcast<T>(self) -> Result<T, Error>
where T: Error + 'static,

Consumes the error, attempting to downcast the inner error as the type provided.

Returns Err(self) if the downcast is not possible.

Source

pub fn get_ref(&self) -> Option<&(dyn Error + Send + Sync + 'static)>

Returns a reference to the inner error wrapped by this error, if any.

Source

pub fn downcast_ref<T>(&self) -> Option<&T>
where T: Error + 'static,

Returns a reference to the inner error, if any, downcast to the type provided.

Source

pub fn get_mut(&mut self) -> Option<&mut (dyn Error + Send + Sync + 'static)>

Returns a mutable reference to the inner error wrapped by this error, if any.

Source

pub fn downcast_mut<T>(&mut self) -> Option<&mut T>
where T: Error + 'static,

Returns a mutable reference to the inner error, if any, downcasting to the type provided.

Trait Implementations§

Source §

impl Debug for Error

Source §

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

Formats the value using the given formatter. Read more

Source §

impl Display for Error

Source §

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

Formats the value using the given formatter. Read more

Source §

impl Error for Error

Source §

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any. Read more

1.0.0 · Source§

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

Source §

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. Read more

Source §