Struct HandoffError 

pub struct HandoffError<H> { /* private fields */ }

A consuming conversion that did not take effect, returned with the handle it was given.

Modelled on std::io::IntoInnerError: an operation that takes ownership has nowhere to put the value back on failure, so it hands it to the caller along with the reason. Receiving one means nothing was surrendered — the handle is exactly as usable as it was before the call — so a caller that only wants the error can discard it, and one that wants to retry can keep it.

It deliberately does not implement Debug in terms of the handle, so that unwrap() works on handles that are not themselves Debug.

Implementations

impl<H> HandoffError<H>

pub fn new(handle: H, error: impl Into<Error>) -> Self

Pairs a handle with the reason its conversion did not happen.

pub fn error(&self) -> &Error

Returns the reason the conversion did not happen.

pub fn into_handle(self) -> H

Recovers the handle, discarding the reason.

pub fn into_error(self) -> Error

Discards the handle, keeping the reason.

pub fn into_parts(self) -> (H, Error)

Splits into the recovered handle and the reason.

Trait Implementations

impl<H> Debug for HandoffError<H>

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

Formats the value using the given formatter.

impl<H> Display for HandoffError<H>

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

Formats the value using the given formatter.

impl<H> Error for HandoffError<H>

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<H> From<HandoffError<H>> for Error

fn from(error: HandoffError<H>) -> Self

Converts to this type from the input type.