Enum nbt::Error

pub enum Error {
    IoError(Error),
    Serde(String),
    InvalidTypeId(u8),
    HeterogeneousList,
    NoRootCompound,
    InvalidUtf8,
    IncompleteNbtValue,
    TagMismatch(u8, u8),
    UnexpectedField(String),
    NonBooleanByte(i8),
    UnrepresentableType(&'static str),
    NonStringMapKey,
}

Errors that may be encountered when constructing, parsing, or encoding NbtValue and NbtBlob objects.

Errors can be seamlessly converted to more general io::Error objects using std::convert::From::from().

Variants

IoError(Error)

Wraps errors emitted by methods during I/O operations.

Serde(String)

Wraps errors emitted during (de-)serialization with serde.

InvalidTypeId(u8)

An error for when an unknown type ID is encountered in decoding NBT binary representations. Includes the ID in question.

HeterogeneousList

An error emitted when trying to create NbtBlobs with incorrect lists.

NoRootCompound

An error for when NBT binary representations do not begin with an NbtValue::Compound.

InvalidUtf8

An error for when NBT binary representations contain invalid UTF-8 strings.

IncompleteNbtValue

An error for when NBT binary representations are missing end tags, contain fewer bytes than advertised, or are otherwise incomplete.

TagMismatch(u8, u8)

An error encountered when parsing NBT binary representations, where deserialization encounters a different tag than expected.

UnexpectedField(String)

An error encountered when parsing NBT binary representations, where deserialization encounters a field name it is not expecting.

NonBooleanByte(i8)

An error encountered when deserializing a boolean from an invalid byte.

UnrepresentableType(&'static str)

An error encountered when serializing a Rust type with no meaningful NBT representation.

NonStringMapKey

An error encountered when trying to (de)serialize a map key with a non-string type.

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

Formats the value using the given formatter.

impl Error for Error

fn source(&self) -> Option<&(dyn StdError + '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()

if let Err(e) = "xc".parse::<u32>() { // Print e itself, no need for description(). eprintln!("Error: {}", e); }

fn cause(&self) -> Option<&dyn Error>

👎 Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

impl Error for Error

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

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

impl Error for Error

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

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.

impl From<Cesu8DecodingError> for Error

fn from(_: Cesu8DecodingError) -> Error

Performs the conversion.

impl From<Error> for Error

fn from(e: Error) -> Error

Performs the conversion.

impl From<Error> for Error

fn from(e: Error) -> Error

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 ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.