Struct SaveStack 

pub struct SaveStack { /* private fields */ }

The save/restore stack.

Implementations

impl SaveStack

pub fn new() -> Self

Create an empty save stack.

pub fn save(&mut self, snapshot: SaveSnapshot) -> (u16, u32)

Push a new save level. Returns (level, save_id).

pub fn add_record(&mut self, record: SaveRecord)

Add a COW record to the current save level.

pub fn restore(&mut self) -> Option<SaveLevel>

Pop the topmost save level, returning its records for restore processing. Returns None if the stack is empty.

pub fn restore_to(&mut self, save_id: u32) -> Option<Vec<SaveLevel>>

Pop all save levels from save_id upward (inclusive), returning them in stack order (target level first, newest level last). Per PLRM, restore can target any valid save — not just the topmost. All newer saves are invalidated and their COW records are also returned so they can be undone.

pub fn current_level(&self) -> u16

Current save level (0 if no save active).

pub fn last_save_id(&self) -> u32

Save ID of the most recent save (0 if no save active). Used for entity creation tracking (invalidrestore).

pub fn is_valid(&self, save_id: u32) -> bool

Check if a save_id is valid (exists and not invalidated).

pub fn depth(&self) -> usize

Number of active save levels.

pub fn levels_ref(&self) -> &[SaveLevel]

Read-only access to the levels (for validation checks).

pub fn invalidate_newer(&mut self, save_id: u32)

Invalidate all save levels newer than the given save_id.

Trait Implementations

impl Default for SaveStack

fn default() -> Self

Returns the “default value” for a type.