Enum StdSourceError 

#[non_exhaustive]
pub enum StdSourceError {
    Source(SourceError),
    Io(Error),
    Allocation {
        requested: usize,
        source: TryReserveError,
    },
}

A source-contract refusal or the original standard-library I/O failure.

The native error retains its kind, OS code and custom payload. Drivers and zencodec::source::ReadAtShim preserve this error in their source chain. A kind does not by itself authorize retry: the source may have consumed input.

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.

Source(SourceError)

The requested range violates the source’s bounds or buffering contract.

Io(Error)

The original filesystem or reader error.

Allocation

Retained input storage could not be reserved before reading.

Fields

requested: usize

Total retained payload capacity requested, excluding allocator overhead.

source: TryReserveError

The allocator’s original refusal.

Trait Implementations

impl Debug for StdSourceError

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

Formats the value using the given formatter.

impl Display for StdSourceError

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

Formats the value using the given formatter.

impl Error for StdSourceError

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 StdSourceError

fn from(error: Error) -> Self

Converts to this type from the input type.

impl From<SourceError> for StdSourceError

fn from(error: SourceError) -> Self

Converts to this type from the input type.