Enum quartz_nbt::NbtReprError

pub enum NbtReprError {
    Structure(Box<NbtStructureError>),
    Custom(Error),
}

An error associated with the translation of a NBT representation to a concrete type. This can either be a structure error, meaning an error in the structure of the NBT tree, or a custom error, which could occur when converting a tag into a concrete type. Most of the conversion processes in this crate return a NbtStructureError when there is a type mismatch or missing tag.

Variants

Structure(Box<NbtStructureError>)

A structure error in the tag tree.

Custom(Error)

A custom error.

Implementations

impl NbtReprError

pub fn structure(error: NbtStructureError) -> Self

Creates a new NBT representation error from the given structure error.

pub fn from_any<E: Into<Error>>(error: E) -> Self

Creates a NbtReprError from the given error. If the given error is a NbtStructureError, then the resulting representation error is of the Structure variant. If the error is a NbtReprError then it is downcasted and returned. All other error types are considered custom errors.

use std::convert::TryFrom;
use std::error::Error;

let tag = NbtTag::Byte(0);
let structure_error = NbtReprError::from_any(i32::try_from(tag).unwrap_err());
assert!(matches!(structure_error, NbtReprError::Structure(..)));

let nested_error = NbtReprError::from_any(structure_error);
assert!(matches!(NbtReprError::from_any(nested_error), NbtReprError::Structure(..)));

let custom_error = "abc".parse::<i32>().unwrap_err();
assert!(matches!(NbtReprError::from_any(custom_error), NbtReprError::Custom(..)));

Trait Implementations

impl Debug for NbtReprError

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

Formats the value using the given formatter.

impl Display for NbtReprError

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

Formats the value using the given formatter.

impl Error for NbtReprError

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<Box<NbtStructureError, Global>> for NbtReprError

fn from(error: Box<NbtStructureError>) -> Self

Performs the conversion.

impl From<NbtStructureError> for NbtReprError

fn from(error: NbtStructureError) -> Self

Performs the conversion.