Struct StateGuard

pub struct StateGuard { /* private fields */ }

State 守卫，使用 RAII 模式自动管理 State 的设置和清理

当 StateGuard 被创建时，会自动设置当前线程的 State 上下文 当 StateGuard 被丢弃时（包括异常情况），会自动清理 State 上下文

示例

use std::sync::Arc;
use moduforge_state::State;
use moduforge_rules_expression::functions::StateGuard;

// 创建 State
let state = Arc::new(create_test_state());

{
    // 设置 State 上下文
    let _guard = StateGuard::new(state);
     
    // 在这个作用域内，自定义函数可以访问 State
    // 即使发生 panic，State 也会被正确清理
     
} // 这里 StateGuard 被自动丢弃，State 上下文被清理

Implementations

impl StateGuard

pub fn new(state: Arc<State>) -> Self

创建新的 State 守卫

参数

• state - 要设置的 State 对象

返回值

返回 StateGuard 实例，当其被丢弃时会自动清理 State

pub fn empty() -> Self

创建空的 State 守卫（用于清理已有的 State）

返回值

返回 StateGuard 实例，会立即清理当前 State 并在丢弃时保持清理状态

pub fn has_active_state() -> bool

获取当前是否有活跃的 State

返回值

• true - 当前线程有活跃的 State
• false - 当前线程没有 State

Trait Implementations

impl Drop for StateGuard

fn drop(&mut self)

自动清理 State 上下文

当 StateGuard 被丢弃时（正常情况或异常情况）， 会自动清理当前线程的 State 上下文