Enum s2n_quic_core::stream::StreamError

#[non_exhaustive]
pub enum StreamError {
    InvalidStream {
        source: &'static Location<'static>,
    },
    StreamReset {
        error: Error,
        source: &'static Location<'static>,
    },
    SendAfterFinish {
        source: &'static Location<'static>,
    },
    MaxStreamDataSizeExceeded {
        source: &'static Location<'static>,
    },
    ConnectionError {
        error: Error,
    },
    NonReadable {
        source: &'static Location<'static>,
    },
    NonWritable {
        source: &'static Location<'static>,
    },
    SendingBlocked {
        source: &'static Location<'static>,
    },
    NonEmptyOutput {
        source: &'static Location<'static>,
    },
}

Errors that a stream can encounter.

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.

InvalidStream

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

source: &'static Location<'static>

The Stream ID which was referenced is invalid

This could mean the ID is no longer tracked by the Connection.

StreamReset

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

error: Error

source: &'static Location<'static>

The Stream had been reset by the peer via a RESET_STREAM frame.

Inside this frame the peer will deliver an error code, which will be provided by the parameter.

SendAfterFinish

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

source: &'static Location<'static>

A send attempt had been performed on a Stream after it was closed

MaxStreamDataSizeExceeded

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

source: &'static Location<'static>

Attempting to write data would exceed the stream limit

This is caused because the maximum possible amount of data (2^62-1 bytes) had already been written to the Stream.

ConnectionError

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

error: Error

The Stream was reset due to a Connection Error

NonReadable

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

source: &'static Location<'static>

The stream is not readable

NonWritable

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

source: &'static Location<'static>

The stream is not writable

SendingBlocked

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

source: &'static Location<'static>

The stream is blocked on writing data

This is caused by trying to send data before polling readiness

NonEmptyOutput

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

source: &'static Location<'static>

The stream was provided a non-empty placeholder buffer for receiving data.

The application should ensure only empty buffers are provided to receive calls, otherwise it can lead to data loss on the stream.

Implementations

impl StreamError

pub fn source(&self) -> &'static Location<'static>

Returns the panic::Location for the error

Trait Implementations

impl Clone for StreamError

fn clone(&self) -> StreamError

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for StreamError

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

Formats the value using the given formatter.

impl Display for StreamError

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

Formats the value using the given formatter.

impl Error for StreamError

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any.

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

🔬 This is a nightly-only experimental API. (backtrace)

Returns a stack backtrace, if available, of where this error occurred.

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

impl<'a> From<ConnectionClose<'a>> for StreamError

fn from(error: ConnectionClose<'_>) -> Self

Converts to this type from the input type.

impl From<Error> for StreamError

fn from(error: Error) -> Self

Converts to this type from the input type.

impl From<Error> for StreamError

fn from(error: Error) -> Self

Converts to this type from the input type.

impl From<StreamError> for Error

fn from(error: StreamError) -> Self

Converts to this type from the input type.

impl From<StreamError> for ErrorKind

fn from(error: StreamError) -> Self

Converts to this type from the input type.

impl PartialEq<StreamError> for StreamError

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl TryInto for StreamError

fn application_error(&self) -> Option<Error>

Returns the associated Error, if any

impl Copy for StreamError

impl Eq for StreamError

impl StructuralEq for StreamError

impl StructuralPartialEq for StreamError