Enum InvalidFrameReason 

pub enum InvalidFrameReason {
    NullFrame,
    Negative,
    MustBeNonNegative,
    NotInPast {
        current_frame: Frame,
    },
    OutsidePredictionWindow {
        current_frame: Frame,
        max_prediction: usize,
    },
    WrongSavedFrame {
        saved_frame: Frame,
    },
    NotConfirmed {
        confirmed_frame: Frame,
    },
    NullOrNegative,
    MissingState,
    Custom(&'static str),
}

Represents why a frame was invalid.

Using an enum instead of String allows for zero-allocation error construction on hot paths while still providing detailed error messages.

Variants

NullFrame

Frame is NULL_FRAME (-1).

Negative

Frame is negative (other than NULL_FRAME).

MustBeNonNegative

Frame must be non-negative.

NotInPast

Frame is not in the past (must load a frame before current).

Fields

current_frame: Frame

The current frame.

OutsidePredictionWindow

Frame is outside the prediction window.

Fields

current_frame: Frame

The current frame.

max_prediction: usize

The maximum prediction depth.

WrongSavedFrame

The saved state for this frame has the wrong frame number.

Fields

saved_frame: Frame

The frame number in the saved state.

NotConfirmed

Frame is not confirmed yet.

Fields

confirmed_frame: Frame

The highest confirmed frame.

NullOrNegative

Frame is NULL or negative (general validation).

MissingState

No saved state exists for this frame.

Returned when attempting to load a game state that was never saved. This typically indicates a programming error — LoadGameState requests should only be issued for frames that were previously saved via SaveGameState.

Custom(&'static str)

Custom reason (fallback for API compatibility).

Trait Implementations

impl Clone for InvalidFrameReason

fn clone(&self) -> InvalidFrameReason

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InvalidFrameReason

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

Formats the value using the given formatter.

impl Display for InvalidFrameReason

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

Formats the value using the given formatter.

impl Hash for InvalidFrameReason

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for InvalidFrameReason

fn eq(&self, other: &InvalidFrameReason) -> 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 Copy for InvalidFrameReason

impl Eq for InvalidFrameReason

impl StructuralPartialEq for InvalidFrameReason