Struct surf::Error[−][src]

pub struct Error { /* fields omitted */ }

Expand description

The error type for HTTP operations.

Implementations

[src]

impl Error

[src]

pub fn new<S, E>(status: S, error: E) -> Error where
 E: Into<Error>,
 S: TryInto<StatusCode>,
 <S as TryInto<StatusCode>>::Error: Debug,

Create a new error object from any error type.

The error type must be threadsafe and ’static, so that the Error will be as well. If the error type does not provide a backtrace, a backtrace will be created here to ensure that a backtrace exists.

[src]

pub fn from_str<S, M>(status: S, msg: M) -> Error where
 S: TryInto<StatusCode>,
 M: Display + Debug + Send + Sync + 'static,
 <S as TryInto<StatusCode>>::Error: Debug,

Create a new error object from static string.

[src]

pub fn status(&self) -> StatusCode

Get the status code associated with this error.

[src]

pub fn set_status<S>(&mut self, status: S) where
S: TryInto<StatusCode>,
<S as TryInto<StatusCode>>::Error: Debug,

Set the status code associated with this error.

[src]

pub fn backtrace(&self) -> Option<&Backtrace>

Get the backtrace for this Error.

Backtraces are only available on the nightly channel. Tracking issue: rust-lang/rust#53487.

In order for the backtrace to be meaningful, the environment variable RUST_LIB_BACKTRACE=1 must be defined. Backtraces are somewhat expensive to capture in Rust, so we don’t necessarily want to be capturing them all over the place all the time.

Note: This function can be called whether or not backtraces are enabled and available. It will return a None variant if compiled on a toolchain that does not support backtraces, or if executed without backtraces enabled with RUST_LIB_BACKTRACE=1.

[src]

pub fn into_inner(self) -> Error

Returns the inner [anyhow::Error] Note: This will lose status code information

[src]

pub fn downcast<E>(self) -> Result<E, Error> where
E: Display + Debug + Send + Sync + 'static,

Attempt to downcast the error object to a concrete type.

[src]

pub fn downcast_ref<E>(&self) -> Option<&E> where
E: Display + Debug + Send + Sync + 'static,

Downcast this error object by reference.

[src]

pub fn downcast_mut<E>(&mut self) -> Option<&mut E> where
E: Display + Debug + Send + Sync + 'static,

Downcast this error object by mutable reference.

[src]

pub fn type_name(&self) -> Option<&str>

Retrieves a reference to the type name of the error, if available.

[src]

pub fn from_display<D>(error: D) -> Error where
D: Display,

Converts anything which implements Display into an http_types::Error.

This is handy for errors which are not Send + Sync + 'static because std::error::Error requires Display. Note that any assiciated context not included in the Display output will be lost, and so this may be lossy for some types which implement std::error::Error.

Note: Prefer error.into() via From<Into<anyhow::Error>> when possible!

[src]

pub fn from_debug<D>(error: D) -> Error where
D: Debug,

Converts anything which implements Debug into an http_types::Error.

This is handy for errors which are not Send + Sync + 'static because std::error::Error requires Debug. Note that any assiciated context not included in the Debug output will be lost, and so this may be lossy for some types which implement std::error::Error.

Note: Prefer error.into() via From<Into<anyhow::Error>> when possible!