Struct AnyConnectionError 

pub struct AnyConnectionError {
    message: String,
    cause: ErrorCause,
}

Error returned by AnyConnection::connect, AnyConnection::recv_response and the rest of this facade.

Renders as the draft-specific error it came from, so nothing that read the message reads anything different. What is new beside it is Self::cause — the same failure as a value, so a caller can ask which kind of failure it was without branching on draft and without parsing the sentence. See ErrorCause for why the sentence was not enough.

Fields

message: String

cause: ErrorCause

Implementations

impl AnyConnectionError

pub fn facade(message: impl Into<String>) -> Self

A refusal by this facade itself: nothing was written, nothing reached the wire. ErrorCause::Facade.

pub fn message(&self) -> &str

The draft-specific error’s own words, unedited.

pub fn cause(&self) -> &ErrorCause

What stopped the call, as a value.

pub fn is_local(&self) -> bool

Whether the failure was on this side rather than the peer’s.

True for a decode this build would not complete, a message that did not fit the state machine this side drives, and a call this facade refused before writing anything. False for every way a peer can end a stream or a session — which is what an unimplemented message type or an unwelcome parameter looks like from here — and false for ErrorCause::PeerViolation, which is the peer’s doing by definition.

ErrorCause::Endpoint answers true, and it is a narrow claim: the peer’s half of the endpoint’s error type leaves through ErrorCause::PeerViolation before it gets here. What reaches this answer is this endpoint refusing on the way out, plus the variants raised on both paths that no table can tell apart. Those answer true because that is the safe direction, not because they have been shown to be this side’s.

ErrorCause::Unclassified answers false, which is the safe direction: a failure that has not been classified is not evidence of anything.

Trait Implementations

impl Clone for AnyConnectionError

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AnyConnectionError

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

Formats the value using the given formatter.

impl Display for AnyConnectionError

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

Formats the value using the given formatter.

impl Eq for AnyConnectionError

impl Error for AnyConnectionError

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<ConnectionError> for AnyConnectionError

Available on crate feature draft07 only.

fn from(err: ConnectionError) -> Self

Converts to this type from the input type.

impl From<ConnectionError> for AnyConnectionError

Available on crate feature draft08 only.

fn from(err: ConnectionError) -> Self

Converts to this type from the input type.

impl From<ConnectionError> for AnyConnectionError

Available on crate feature draft09 only.

fn from(err: ConnectionError) -> Self

Converts to this type from the input type.

impl From<ConnectionError> for AnyConnectionError

Available on crate feature draft10 only.

fn from(err: ConnectionError) -> Self

Converts to this type from the input type.

impl From<ConnectionError> for AnyConnectionError

Available on crate feature draft11 only.

fn from(err: ConnectionError) -> Self

Converts to this type from the input type.

impl From<ConnectionError> for AnyConnectionError

Available on crate feature draft12 only.

fn from(err: ConnectionError) -> Self

Converts to this type from the input type.

impl From<ConnectionError> for AnyConnectionError

Available on crate feature draft13 only.

fn from(err: ConnectionError) -> Self

Converts to this type from the input type.

impl From<ConnectionError> for AnyConnectionError

Available on crate feature draft14 only.

fn from(err: ConnectionError) -> Self

Converts to this type from the input type.

impl From<ConnectionError> for AnyConnectionError

Available on crate feature draft15 only.

fn from(err: ConnectionError) -> Self

Converts to this type from the input type.

impl From<ConnectionError> for AnyConnectionError

Available on crate feature draft16 only.

fn from(err: ConnectionError) -> Self

Converts to this type from the input type.

impl From<ConnectionError> for AnyConnectionError

Available on crate feature draft17 only.

fn from(err: ConnectionError) -> Self

Converts to this type from the input type.

impl From<ConnectionError> for AnyConnectionError

Available on crate feature draft18 only.

fn from(err: ConnectionError) -> Self

Converts to this type from the input type.

impl From<ConnectionError> for AnyConnectionError

Available on crate feature draft19 only.

fn from(err: ConnectionError) -> Self

Converts to this type from the input type.

impl From<ConnectionError> for AnyConnectionError

Available on crate feature draft20 only.

fn from(err: ConnectionError) -> Self

Converts to this type from the input type.

impl From<ConnectionError> for AnyConnectionError

Available on crate feature draft21 only.

fn from(err: ConnectionError) -> Self

Converts to this type from the input type.

impl PartialEq for AnyConnectionError

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for AnyConnectionError