Skip to main content

SaveError

Enum SaveError 

Source
pub enum SaveError {
Show 13 variants TruncatedHeader { bytes: usize, }, BadMagic, UnsupportedFormat { found: u32, }, UnsupportedSchema { expected: u32, found: u32, }, TooLarge { bytes: u64, limit: usize, }, SizeOverflow, LengthMismatch { declared: u64, actual: u64, }, ChecksumMismatch { expected: u32, actual: u32, }, InvalidPath, NotRegularFile, UnsupportedDurability, Allocation(TryReserveError), Io { stage: SaveStage, source: Error, },
}
Expand description

Container validation or filesystem failure. No recovery is performed implicitly.

Variants§

§

TruncatedHeader

A header ended before all fixed fields were available.

Fields

§bytes: usize

Available header bytes.

§

BadMagic

The file is not a rayengine save container.

§

UnsupportedFormat

The engine cannot decode this container format.

Fields

§found: u32

Recorded container version.

§

UnsupportedSchema

A strict game schema check failed; migration is game-owned.

Fields

§expected: u32

Required game schema.

§found: u32

Recorded game schema.

§

TooLarge

Declared payload size exceeds the configured bound.

Fields

§bytes: u64

Declared payload bytes.

§limit: usize

Configured byte limit.

§

SizeOverflow

Header/payload size cannot be represented on this platform.

§

LengthMismatch

Truncation or trailing data disagrees with the declared payload size.

Fields

§declared: u64

Declared payload bytes.

§actual: u64

Available payload bytes.

§

ChecksumMismatch

CRC32 of the header prefix and payload did not match.

Fields

§expected: u32

Stored checksum.

§actual: u32

Calculated checksum.

§

InvalidPath

Destination must name a file, with an existing stable parent directory.

§

NotRegularFile

Loading requires a regular file.

§

UnsupportedDurability

Linux durable semantics are unavailable on this target.

§

Allocation(TryReserveError)

Bounded container allocation failed.

§

Io

An operating-system operation failed.

Fields

§stage: SaveStage

Operation that failed.

§source: Error

Original operating-system error.

Implementations§

Source§

impl SaveError

Source

pub fn commit_state(&self) -> CommitState

Disposition for recovery after a save operation. Rename errors are conservatively ambiguous (notably on network filesystems). A directory sync error means the new container is already installed; never roll it back implicitly. Load/validation errors do not modify files.

Trait Implementations§

Source§

impl Debug for SaveError

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Display for SaveError

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Error for SaveError

Source§

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any. Read more
1.0.0 · Source§

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

1.0.0 · Source§

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

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

Source§

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. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> Component for T
where T: Send + Sync + 'static,

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.