Struct Error 

pub struct Error { /* private fields */ }

An error encountered when communicating with the service.

Implementations

impl Error

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

where E: Into<Box<dyn Error + Send + Sync>>,

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

pub fn with_error<E, C>(kind: ErrorKind, error: E, message: C) -> Self

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.

pub fn with_error_fn<E, F, C>(kind: ErrorKind, error: E, f: F) -> Self

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.

pub fn with_message<C>(kind: ErrorKind, message: C) -> Self

where C: Into<Cow<'static, str>>,

Create an Error based on an ErrorKind and a message.

pub fn with_message_fn<F, C>(kind: ErrorKind, f: F) -> Self

where F: FnOnce() -> C, C: Into<Cow<'static, str>>,

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

pub fn with_context<C>(self, message: C) -> Self

where C: Into<Cow<'static, str>>,

Wrap this error with an additional message.

pub fn with_context_fn<F, C>(self, f: F) -> Self

where F: FnOnce() -> C, C: Into<Cow<'static, str>>,

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

pub fn kind(&self) -> &ErrorKind

Get the ErrorKind of this Error.

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

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

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

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

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

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

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

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

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

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

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

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.

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

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

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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<!> for Error

fn from(_: Infallible) -> Self

Converts to this type from the input type.

impl From<DecodeError> for Error

fn from(error: DecodeError) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(error: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

Available on crate feature json only.

fn from(error: Error) -> Self

Converts to this type from the input type.

impl From<ErrorKind> for Error

fn from(kind: ErrorKind) -> Self

Converts to this type from the input type.

impl From<FromUtf8Error> for Error

fn from(error: FromUtf8Error) -> Self

Converts to this type from the input type.

impl From<ParseBoolError> for Error

fn from(error: ParseBoolError) -> Self

Converts to this type from the input type.

impl From<ParseError> for Error

fn from(error: ParseError) -> Self

Converts to this type from the input type.

impl From<ParseIntError> for Error

fn from(error: ParseIntError) -> Self

Converts to this type from the input type.

impl From<Utf8Error> for Error

fn from(error: Utf8Error) -> Self

Converts to this type from the input type.