Enum VisitError 

pub enum VisitError {
    Multiple(Vec<VisitError>),
    Io(Error),
    UnknownFieldType(u8),
    FieldDoesNotExist(String),
    FieldAlreadyExists(String),
    RegionAlreadyExists(String),
    InvalidCurrentNode,
    FieldTypeDoesNotMatch {
        expected: &'static str,
        actual: String,
    },
    RegionDoesNotExist(String),
    NoActiveNode,
    NotSupportedFormat,
    InvalidName,
    TypeMismatch {
        expected: &'static str,
        actual: &'static str,
    },
    RefCellAlreadyMutableBorrowed,
    User(String),
    UnexpectedRcNullIndex,
    PoisonedMutex,
    FileLoadError(FileError),
    ParseIntError(ParseIntError),
    ParseFloatError(ParseFloatError),
    DecodeError(DecodeError),
    UuidError(Error),
    Any(Box<dyn Error + Send + Sync>),
}

Errors that may occur while reading or writing crate::visitor::Visitor.

Variants

Multiple(Vec<VisitError>)

An error that occured for multiple reasons, when there are multiple potential ways to visit a node, and all of them lead to errors.

Io(Error)

An std::io::Error occured while reading or writing a file with Visitor data.

UnknownFieldType(u8)

When a field is encoded as bytes, the field data is prefixed by an identifying byte to allow the bytes to be decoded. This error happens when an identifying byte is expected during decoding, but an unknown value is found in that byte.

FieldDoesNotExist(String)

Attempting to visit a field on a read-mode Visitor when no field in the visitor data has the given name.

FieldAlreadyExists(String)

Attempting to visit a field on a write-mode Visitor when a field already has the given name.

RegionAlreadyExists(String)

Attempting to enter a region on a write-mode Visitor when a region already has the given name.

InvalidCurrentNode

Current node handle is invalid and does not lead to a real node.

FieldTypeDoesNotMatch

Attempting to visit a field using a read-mode Visitor when that field was originally written using a value of a different type.

Fields

expected: &'static str

expected crate::visitor::FieldKind variant name, for instance “FieldKind::F64”

actual: String

Debug representation of actual crate::visitor::FieldKind

RegionDoesNotExist(String)

Attempting to enter a region on a read-mode Visitor when no region in the visitor’s data has the given name.

NoActiveNode

The Visitor tried to leave is current node, but somehow it had no current node. This should never happen.

NotSupportedFormat

The crate::Visitor::MAGIC_BINARY_CURRENT, crate::Visitor::MAGIC_ASCII_CURRENT. bytes were missing from the beginning of encoded Visitor data.

InvalidName

Some sequence of bytes was not in UTF8 format.

TypeMismatch

Visitor data can be self-referential, such as when the data contains multiple Rc references to a single shared value. This causes the visitor to store the data once and then later references to the same value point back to its first occurrence. This error occurs if one of these references points to a value of the wrong type.

Fields

expected: &'static str

The type that was visiting when the error occurred.

actual: &'static str

The type that was stored in the Rc or Arc.

RefCellAlreadyMutableBorrowed

Attempting to visit a mutably borrowed RefCell.

User(String)

A plain-text error message that could indicate almost anything.

UnexpectedRcNullIndex

Rc and Arc values store an “Id” value in the Visitor data which is based in their internal pointer. This error indicates that while reading this data, one of those Id values was discovered by be 0.

PoisonedMutex

A poison error occurred while trying to visit a mutex.

FileLoadError(FileError)

A FileLoadError was encountered while trying to decode Visitor data from a file.

ParseIntError(ParseIntError)

Integer parsing error.

ParseFloatError(ParseFloatError)

Floating point number parsing error.

DecodeError(DecodeError)

An error occurred when trying to decode base64-encoded data.

UuidError(Error)

An error occurred when trying to parse uuid from a string.

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

Arbitrary error.

Implementations

impl VisitError

pub fn field_does_not_exist(name: &str, visitor: &Visitor) -> Self

Create a VisitError::FieldDoesNotExist containing the given field name and the breadcrumbs of the current visitor node.

pub fn multiple(self, other: Self) -> Self

Create an error from two errors.

Trait Implementations

impl Debug for VisitError

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

Formats the value using the given formatter.

impl Display for VisitError

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

Formats the value using the given formatter.

impl Error for VisitError

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 From<Box<dyn Error + Send + Sync>> for VisitError

fn from(value: Box<dyn Error + Send + Sync>) -> Self

Converts to this type from the input type.

impl From<DecodeError> for VisitError

fn from(value: DecodeError) -> Self

Converts to this type from the input type.

impl From<Error> for VisitError

fn from(io_err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for VisitError

fn from(value: Error) -> Self

Converts to this type from the input type.

impl From<FileError> for VisitError

fn from(e: FileError) -> Self

Converts to this type from the input type.

impl From<FromUtf8Error> for VisitError

fn from(_: FromUtf8Error) -> Self

Converts to this type from the input type.

impl From<ParseFloatError> for VisitError

fn from(value: ParseFloatError) -> Self

Converts to this type from the input type.

impl From<ParseIntError> for VisitError

fn from(value: ParseIntError) -> Self

Converts to this type from the input type.

impl<T> From<PoisonError<&mut T>> for VisitError

fn from(_: PoisonError<&mut T>) -> Self

Converts to this type from the input type.

impl<T> From<PoisonError<MutexGuard<'_, T>>> for VisitError

fn from(_: PoisonError<MutexGuard<'_, T>>) -> Self

Converts to this type from the input type.

impl<T> From<PoisonError<RwLockWriteGuard<'_, T>>> for VisitError

fn from(_: PoisonError<RwLockWriteGuard<'_, T>>) -> Self

Converts to this type from the input type.

impl From<String> for VisitError

fn from(s: String) -> Self

Converts to this type from the input type.