dynamic/
fault.rs

1//! 运行期错误标志。
2//!
3//! JIT 编译出的脚本代码无法像普通 Rust 函数那样返回 `Result`,因此用一个线程
4//! 局部标志记录"本次脚本执行中发生过运行期错误"(例如整数除零)。脚本入口的
5//! 隔离边界在调用结束后用 [`take_fault`] 读取并清空它,把崩溃降级为一次失败的
6//! 调用,而不是杀掉整个进程。
7//!
8//! 这个标志放在最底层的 `dynamic` crate,使得动态值运算([`crate::Dynamic`] 的
9//! 除法/取余)和 VM 生成的守卫代码可以写同一个标志位。
10
11use std::cell::Cell;
12
13thread_local! {
14    static RUNTIME_FAULT: Cell<Option<&'static str>> = const { Cell::new(None) };
15}
16
17/// 记录一次运行期错误。只保留第一个原因(最早发生的错误信息最有用)。
18pub fn set_fault(reason: &'static str) {
19    RUNTIME_FAULT.with(|fault| {
20        if fault.get().is_none() {
21            fault.set(Some(reason));
22        }
23    });
24}
25
26/// 读取并清空当前线程的运行期错误标志。
27pub fn take_fault() -> Option<&'static str> {
28    RUNTIME_FAULT.with(|fault| fault.take())
29}
30
31/// 是否已经发生过运行期错误(不清空)。
32pub fn has_fault() -> bool {
33    RUNTIME_FAULT.with(|fault| fault.get().is_some())
34}
dynamic/fault.rs

dynamic/
fault.rs
