Enum ChannelError 

#[non_exhaustive]
pub enum ChannelError {
    Io(String),
    Closed,
    NoReceiver,
    NoReply,
    NotSupported(String),
}

The reason a message channel failed.

When each variant is triggered:

• ChannelError::Io — underlying read/write failure (e.g. a terminal IO error);
• ChannelError::Closed — the channel is closed: the peer has been dropped, or input ended (e.g. Ctrl-D in a terminal); after it closes, every subsequent call on the channel returns the same error;
• ChannelError::NoReply — IncomingMessage::reply was called on a notification message that does not expect a reply;
• ChannelError::NotSupported — the current implementation does not support this operation (broadcast / watch don’t support ask).

The enum is #[non_exhaustive] (reserved for extension): matches must include a wildcard arm.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Io(String)

Underlying IO failure (reading or writing the channel failed).

Closed

Input has been closed (e.g. user pressed Ctrl-D); no reply is available.

NoReceiver

There are currently no receivers on the channel (e.g. notify on a watch channel with no subscribers). The channel itself is not closed: subscribing again restores operation.

NoReply

reply was called on a message (a notification) that has no reply channel.

NotSupported(String)

This channel implementation does not support the operation (e.g. broadcast / watch don’t support ask).

Trait Implementations

impl Clone for ChannelError

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 ChannelError

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

Formats the value using the given formatter.

impl Display for ChannelError

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

Formats the value using the given formatter.

impl Error for ChannelError

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

fn from(err: Error) -> Self

Converts to this type from the input type.

impl PartialEq for ChannelError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ChannelError