Enum Error 

#[non_exhaustive]
pub enum Error {
    StreamReadFailed(Box<dyn Error + Send + Sync>),
    InvalidBoundary,
    InvalidFormat,
    IncompleteStream,
    HeaderSizeExceeded {
        limit: usize,
    },
    StreamPartNotLast,
    StreamAlreadyTaken,
    IncompleteStreamPart,
}

Errors produced while parsing a multipart body.

The enum is #[non_exhaustive]: more variants may be added in a minor release, so downstream match expressions need a wildcard arm. Existing variants stay constructible.

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.

StreamReadFailed(Box<dyn Error + Send + Sync>)

The underlying stream returned an error.

InvalidBoundary

The supplied boundary is invalid.

InvalidFormat

The body is not valid multipart data.

IncompleteStream

The stream ended before the expected multipart structure.

HeaderSizeExceeded

The accumulated part headers exceed the configured buffer limit.

Fields

limit: usize

The configured buffer limit that was exceeded.

StreamPartNotLast

A FinalPartDataStream found content after the closing delimiter that is not the strict closing trailer (an epilogue or another part).

StreamAlreadyTaken

The multipart parser was already terminated by take_data_stream.

IncompleteStreamPart

A taken part data stream ended before the closing delimiter.

Implementations

impl Error

pub fn stream_read_failed( source: impl Into<Box<dyn Error + Send + Sync>>, ) -> Self

Wraps an error returned by the underlying stream.

Equivalent to constructing Error::StreamReadFailed directly, with the source boxed for you; convenient as a map_err function.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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.