Enum Exception

pub enum Exception {
    EndOfStream,
    LimitReached,
    ReadError(Error),
    WriteError(Error),
    ConnectError(Error),
}

An exception value that is received in Protocol::exception method

This thing is usually used for nice error detection. But sometimes it is also useful for valid protocol processing. For example it allows to detect end-of-stream-delimited prootols (of those which make of use of TCP half close)

Variants

EndOfStream

End of stream reached (when reading)

This may be not a broken expectation, we just notify of end of stream always (if the state machine is still alive)

Note: the equivalent of end of stream for write system call is translated to WriteError(WriteZero)

LimitReached

Limit for the number of bytes reached

This is called when there is alredy maximum bytes in the buffer (third argument of Delimiter) but no delimiter found.

ReadError(Error)

WriteError(Error)

ConnectError(Error)

Trait Implementations

impl Debug for Exception

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

Formats the value using the given formatter.

impl Display for Exception

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

Formats the value using the given formatter.

impl Error for Exception

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 source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

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.