Enum StateSeriesError 

#[non_exhaustive]
pub enum StateSeriesError {
    SchemaMismatch {
        iteration: u64,
    },
    NonIncreasingIteration {
        previous: u64,
        next: u64,
    },
    PositionOutOfBounds {
        position: usize,
        len: usize,
    },
    PayloadAccess {
        position: usize,
        source: StateError,
    },
}

A failure produced while maintaining or mutating an in-memory state series.

The enum is intentionally small and independent of persistence. Every variant is either a collection invariant violation or contextualized typed access into one already-stored state.

StateSeriesError is non-exhaustive so additional analysis invariants can be introduced without forcing downstream crates to use exhaustive matches. Callers should therefore retain a fallback match arm.

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.

SchemaMismatch

The rejected state does not share the series’ canonical layout.

Structural equality is insufficient: accepted states must derive from the same SystemStateSchema allocation. The rejected state’s iteration is retained for diagnostics without inspecting or formatting any scientific payload.

Fields

iteration: u64

Iteration carried by the rejected state.

NonIncreasingIteration

The rejected state would violate strictly increasing simulation order.

Iteration gaps are permitted, but an equal or decreasing value would make ordered iteration ambiguous. Physical time is not used for ordering because it is optional and may follow an application-specific scale.

Fields

previous: u64

Iteration of the series’ current final state.

next: u64

Iteration carried by the rejected state.

PositionOutOfBounds

A mutable analysis request selected no stored state.

position is a zero-based position in the series rather than a simulation iteration. Both the attempted position and current length are recorded so callers can diagnose stale analysis selections.

Fields

position: usize

Zero-based series position requested by the caller.

len: usize

Number of states stored when the request was evaluated.

PayloadAccess

Typed mutable access failed inside the selected state.

The source distinguishes an undeclared key, an empty field, and a concrete payload type mismatch. Wrapping it here adds the series position while preserving std::error::Error::source traversal.

Fields

position: usize

Zero-based position of the state containing the requested field.

source: StateError

Original typed access failure reported by SystemState::payload_mut.

Trait Implementations

impl Debug for StateSeriesError

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

Formats the value using the given formatter.

impl Display for StateSeriesError

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

Formats the value using the given formatter.

impl Error for StateSeriesError

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.