Enum Kind 

#[non_exhaustive]
pub enum Kind {
    VersionMismatch,
    MissingField,
    TypeMismatch,
    UnknownVersion,
    UnknownVariant,
    NumberOutOfRange,
    MissingFile,
}

Well-known classes of load-side failure.

Used in two roles:

• As the source of an Error via From<Kind> (and the matching From<Kind> for Error which classifies recoverable / critical according to Kind::is_recoverable).
• As a probe value in error chains — high-level callers can introspect the kind to decide whether to try a fallback loader.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

VersionMismatch

The manifest’s $version does not match the loader’s expected Load::VERSION.

MissingField

A required field is absent from the record.

TypeMismatch

The shape of the saved value does not match what the loader expected (e.g. found an array where an object was needed).

UnknownVersion

The manifest’s version is recognized as not matching the current schema, and the type’s Load::load_legacy has no upgrade path for it.

UnknownVariant

The variant tag read from the wire format does not match any known variant of the target enum.

NumberOutOfRange

A numeric value in the manifest does not fit in the requested Rust type (either out of range or would lose precision).

MissingFile

A $handle references a file name that is not registered in the manifest’s files set.

Implementations

impl Kind

pub const fn as_str(self) -> &'static str

Stable, human-readable description of this kind. Used as the default error message when constructing an Error from a Kind.

pub const fn is_recoverable(self) -> bool

Whether an error of this kind should be treated as recoverable by probing APIs (i.e., suitable for triggering a fallback to an alternative load strategy).

Recoverable kinds describe “the data did not match what this loader expected” (a different version or shape might still succeed). Critical kinds describe structural or integrity problems where retrying would be pointless or unsafe.

Trait Implementations

impl Clone for Kind

fn clone(&self) -> Kind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Kind

impl Debug for Kind

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

Formats the value using the given formatter.

impl Display for Kind

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

Formats the value using the given formatter.

impl Error for Kind

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

fn from(kind: Kind) -> Self

Converts to this type from the input type.