Enum Error 

pub enum Error {
    InvalidInteger {
        position: usize,
        detail: String,
    },
    InvalidByteString {
        position: usize,
        detail: String,
    },
    UnexpectedByte {
        byte: u8,
        position: usize,
        expected: &'static str,
    },
    UnexpectedEof {
        position: usize,
        context: String,
    },
    UnsortedKeys {
        position: usize,
    },
    TrailingData {
        position: usize,
        count: usize,
    },
    KeyNotFound {
        key: String,
    },
    NotADictionary {
        position: usize,
    },
    Custom(String),
}

Errors that can occur during bencode serialization or deserialization.

Variants

InvalidInteger

Integer overflow or invalid integer value.

Fields

position: usize

Byte offset where the error occurred.

detail: String

Description of the problem.

InvalidByteString

Invalid byte string (bad length prefix, truncated, etc).

Fields

position: usize

Byte offset where the error occurred.

detail: String

Description of the problem.

UnexpectedByte

Unexpected byte encountered during parsing.

Fields

byte: u8

The byte that was found.

position: usize

Byte offset where the error occurred.

expected: &'static str

What was expected instead.

UnexpectedEof

Input ended prematurely.

Fields

position: usize

Byte offset where the error occurred.

context: String

Description of what was being parsed.

UnsortedKeys

Dictionary keys are not in sorted order (BEP 3 violation).

Fields

position: usize

Byte offset of the out-of-order key.

TrailingData

Trailing bytes after the top-level value.

Fields

position: usize

Byte offset where trailing data begins.

count: usize

Number of trailing bytes.

KeyNotFound

The key in find_dict_key_span was not found.

Fields

key: String

The key that was not found.

NotADictionary

Input is not a dictionary (for find_dict_key_span).

Fields

position: usize

Byte offset where the non-dictionary value was found.

Custom(String)

Custom error from serde.

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.

impl Error for Error

fn custom<T: Display>(msg: T) -> Self

Used when a Serialize implementation encounters any error while serializing a type.

impl Error for Error

fn custom<T: Display>(msg: T) -> Self

Raised when there is general error when deserializing a type.

fn invalid_type(unexp: Unexpected<'_>, exp: &dyn Expected) -> Self

Raised when a Deserialize receives a type different from what it was expecting.

fn invalid_value(unexp: Unexpected<'_>, exp: &dyn Expected) -> Self

Raised when a Deserialize receives a value of the right type but that is wrong for some other reason.

fn invalid_length(len: usize, exp: &dyn Expected) -> Self

Raised when deserializing a sequence or map and the input data contains too many or too few elements.

fn unknown_variant(variant: &str, expected: &'static [&'static str]) -> Self

Raised when a Deserialize enum type received a variant with an unrecognized name.

fn unknown_field(field: &str, expected: &'static [&'static str]) -> Self

Raised when a Deserialize struct type received a field with an unrecognized name.

fn missing_field(field: &'static str) -> Self

Raised when a Deserialize struct type expected to receive a required field with a particular name but that field was not present in the input.

fn duplicate_field(field: &'static str) -> Self

Raised when a Deserialize struct type received more than one of the same field.