Struct OnionStaticObject

pub struct OnionStaticObject { /* private fields */ }

Onion 静态对象封装。

稳定化的对象封装，用于跨函数调用、长期存储和序列化。 通过持有必要的强引用来确保对象在使用期间不被 GC 回收。

设计目的

• 跨边界传递: 在函数调用、模块间传递对象
• 长期存储: 作为常量、全局变量等存储
• GC 稳定性: 确保对象在使用期间不被回收
• 序列化支持: 提供对象的稳定表示

内部结构

• obj: 实际的对象数据
• _arcs: GC 强引用存储，防止对象被回收

GC 策略

根据对象类型采用不同的 GC 策略：

• 基础类型: 无需额外引用（如 Integer, String 等）
• Mut 类型: 持有单个强引用
• 复杂类型: 持有多个强引用（如 Tuple, Lambda 等）

关键方法

• new(): 创建静态对象并自动设置 GC 引用
• weak(): 获取内部对象的弱引用
• mutablize(): 转换为可变对象
• immutablize(): 从可变对象中提取值

Implementations

impl OnionStaticObject

pub fn new(obj: OnionObject) -> Self

pub fn weak(&self) -> &OnionObject

pub fn mutablize(self, gc: &mut GC<OnionObjectCell>) -> OnionStaticObject

将值装箱成可变容器，严格遵循幂等律的情况下，Cell里不可能出现Mut对象。 也就是说，mut mut x和mut x是等价的。

pub fn immutablize(self) -> Result<OnionStaticObject, RuntimeError>

将值从可变容器中卸载，严格遵循幂等律 也就是说，const const x和const x是等价的。

Trait Implementations

impl Clone for OnionStaticObject

fn clone(&self) -> OnionStaticObject

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for OnionStaticObject

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

Formats the value using the given formatter.

impl Default for OnionStaticObject

fn default() -> Self

Returns the “default value” for a type.

impl Display for OnionStaticObject

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

Formats the value using the given formatter.