Enum strict_encoding::Error

pub enum Error {
    Io(IoError),
    Utf8Conversion(Utf8Error),
    ExceedMaxItems(usize),
    WrongOptionalEncoding(u8),
    EnumValueOverflow(&'static str),
    EnumValueNotKnown(&'static str, usize),
    UnsupportedDataStructure(&'static str),
    ValueOutOfRange(&'static str, Range<u128>, u128),
    RepeatedValue(String),
    DataNotEntirelyConsumed,
    DataIntegrityError(String),
}

Possible errors during strict encoding and decoding process

Variants

Io

I/O error during data strict encoding

Tuple Fields of Io

0: IoError

Utf8Conversion

String data are not in valid UTF-8 encoding

Tuple Fields of Utf8Conversion

0: Utf8Error

ExceedMaxItems

A collection (slice, vector or other type) has more items ({0}) than 2^16 (i.e. maximum value which may be held by u16 size representation according to the LNPBP-6 spec)

Tuple Fields of ExceedMaxItems

0: usize

WrongOptionalEncoding

In terms of strict encoding, we interpret Option as a zero-length Vec (for Optional::None) or single-item Vec (for Optional::Some). For decoding an attempt to read Option from a encoded non-0 or non-1 length Vec will result in Error::WrongOptionalEncoding.

Tuple Fields of WrongOptionalEncoding

0: u8

EnumValueOverflow

Enum {0} value does not fit into representation bit dimensions

Tuple Fields of EnumValueOverflow

0: &'static str

EnumValueNotKnown

An unsupported value {0} for enum {0} encountered during decode operation

Tuple Fields of EnumValueNotKnown

0: &'static str1: usize

UnsupportedDataStructure

The data are correct, however their structure indicate that they were created with the future software version which has a functional absent in the current implementation. {0}

Tuple Fields of UnsupportedDataStructure

0: &'static str

ValueOutOfRange

Decoding resulted in value {2} for type {0} that exceeds the supported range {1:#?}

Tuple Fields of ValueOutOfRange

0: &'static str1: Range<u128>2: u128

RepeatedValue

A repeated value for {0} found during set collection deserialization

Tuple Fields of RepeatedValue

0: String

DataNotEntirelyConsumed

Returned by the convenience method StrictDecode::strict_decode if not all provided data were consumed during decoding process

DataIntegrityError

Data integrity problem during strict decoding operation: {0}

Tuple Fields of DataIntegrityError

0: String

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a copy of the value.

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

Performs copy-assignment from source.

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, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for Error

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 From<Error> for Error

fn from(_: Error) -> Self

Performs the conversion.

impl From<Error> for Error

fn from(e: Error) -> Self

Performs the conversion.

impl From<Error> for Error

fn from(v: Error) -> Self

Performs the conversion.

impl From<Error> for String

fn from(err: Error) -> Self

Performs the conversion.

impl From<Error> for Error

fn from(_: Error) -> Self

Performs the conversion.

impl From<ErrorKind> for Error

fn from(v: ErrorKind) -> Self

Performs the conversion.

impl From<FromUtf8Error> for Error

fn from(err: FromUtf8Error) -> Self

Performs the conversion.

impl From<TlvError> for Error

fn from(err: TlvError) -> Self

Performs the conversion.

impl From<Utf8Error> for Error

fn from(v: Utf8Error) -> Self

Performs the conversion.

impl PartialEq<Error> for Error

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

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

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

This method tests for !=.

impl Eq for Error

impl StructuralEq for Error

impl StructuralPartialEq for Error