Enum SaveStateError 

#[non_exhaustive]
pub enum SaveStateError {
    Truncated {
        expected: usize,
        available: usize,
    },
    UnexpectedTag {
        expected: [u8; 4],
        found: [u8; 4],
    },
    BadMagic,
    UnsupportedVersion {
        found: u16,
        max: u16,
    },
    Invalid(String),
}

Errors from decoding a save-state.

docs/adr/0006’s “reject loudly on an unrecognized/corrupt format, never silently truncate or zero-fill” honesty posture — the same posture docs/adr/0003 already applies to coprocessor accuracy.

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.

Truncated

The buffer ended before the expected number of bytes were available.

Fields

expected: usize

Bytes the read attempted to consume.

available: usize

Bytes actually remaining in the buffer.

UnexpectedTag

A section’s declared tag didn’t match what the caller expected at this point in the format — either genuine corruption, or a format version whose section order changed.

Fields

expected: [u8; 4]

The 4-byte ASCII tag the caller expected.

found: [u8; 4]

The 4-byte ASCII tag actually present.

BadMagic

The blob’s leading magic bytes didn’t match — not a RustySNES save-state at all.

UnsupportedVersion

The blob’s format-version major number is newer than this build understands.

Fields

found: u16

The format major version found in the blob.

max: u16

The highest format major version this build can load.

Invalid(String)

A component rejected the decoded bytes as semantically invalid (e.g. an enum discriminant with no matching variant) even though the section framing itself was well-formed.

Trait Implementations

impl Debug for SaveStateError

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

Formats the value using the given formatter.

impl Display for SaveStateError

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

Formats the value using the given formatter.

impl Error for SaveStateError

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 PartialEq for SaveStateError

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for SaveStateError

impl StructuralPartialEq for SaveStateError