Struct HistoryManager

pub struct HistoryManager<T: Clone> { /* private fields */ }

历史管理器

Implementations

impl<T: Clone> HistoryManager<T>

pub fn new(initial_state: T, history_limit: Option<usize>) -> Self

创建新的历史管理器

pub fn with_config(initial_state: T, config: HistoryConfig) -> Self

使用配置创建历史管理器

pub fn get_present(&self) -> T

获取当前状态

pub fn get_history(&self) -> &History<T>

获取历史记录

pub fn get_history_length(&self) -> usize

获取历史记录长度

pub fn get_config(&self) -> &HistoryConfig

获取历史配置

pub fn update_config(&mut self, config: HistoryConfig)

更新历史配置

pub fn insert(&mut self, state: T)

插入新状态

当历史记录超出最大限制时，自动舍弃最旧的记录

pub fn jump_to_future(&mut self, index: usize)

跳转到未来状态

边界检查

• 检查索引是否在有效范围内
• 安全的数组切片操作

pub fn jump_to_past(&mut self, index: usize)

跳转到过去状态

边界检查

• 检查索引是否在有效范围内
• 安全的数组切片操作

pub fn jump(&mut self, n: isize)

通用跳转方法

参数

• n: 跳转的步数
  • 负数：向过去跳转
  • 正数：向未来跳转
  • 0：不跳转

边界检查

• 自动限制在有效范围内
• 超出范围的跳转会被忽略

pub fn clear_history(&mut self)

清空历史记录

pub fn get_past_state(&self, index: usize) -> Option<&T>

安全地获取过去状态

边界检查

• 返回 Option 以处理无效索引

pub fn get_future_state(&self, index: usize) -> Option<&T>

安全地获取未来状态

边界检查

• 返回 Option 以处理无效索引

pub fn can_undo(&self) -> bool

检查是否可以撤销（向过去跳转）

pub fn can_redo(&self) -> bool

检查是否可以重做（向未来跳转）

pub fn past_count(&self) -> usize

获取过去状态的数量

pub fn future_count(&self) -> usize

获取未来状态的数量

pub fn validate_integrity(&self) -> bool

验证历史记录的完整性

用于调试和测试，确保历史记录结构正确