Struct OnionTuple

pub struct OnionTuple { /* private fields */ }

Onion 元组类型。

封装有序对象集合，支持高效的索引访问与属性查找。

字段

• elements: 元组元素的有序对象数组

Implementations

impl OnionTuple

pub fn new(elements: Vec<OnionObject>) -> Self

创建新的元组。

参数

• elements: 元组元素对象列表

返回

新的元组实例

pub fn new_static(elements: Vec<&OnionStaticObject>) -> OnionStaticObject

创建静态元组对象（元素为静态对象）。

参数

• elements: 静态对象引用列表

返回

稳定化后的静态元组对象

pub fn new_static_no_ref(elements: &Vec<OnionStaticObject>) -> OnionStaticObject

创建静态元组对象（元素为静态对象，参数为 Vec 所有权）。

参数

• elements: 静态对象列表

返回

稳定化后的静态元组对象

pub fn new_from_slice(elements: &[OnionStaticObject]) -> OnionStaticObject

创建静态元组对象（元素为静态对象，参数为切片）。

参数

• elements: 静态对象切片

返回

稳定化后的静态元组对象

pub fn get_elements(&self) -> &[OnionObject]

获取元组元素的引用。

pub fn upgrade(&self, collected: &mut Vec<GCArc<OnionObjectCell>>)

升级元组中所有元素的对象引用。

用于 GC 跟踪，防止元素被提前回收。

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

获取元组长度。

返回

元组长度的静态整数对象

pub fn at(&self, index: i64) -> Result<OnionStaticObject, RuntimeError>

按索引访问元组元素。

参数

• index: 元组索引（从 0 开始）

返回

对应索引的静态对象

错误

• InvalidOperation: 索引越界

pub fn with_index<F, R>(&self, index: i64, f: &F) -> Result<R, RuntimeError>

where F: Fn(&OnionObject) -> Result<R, RuntimeError>,

按索引借用元组元素并应用函数。

参数

• index: 元组索引
• f: 处理函数

返回

处理函数的返回值

错误

• InvalidOperation: 索引越界

pub fn with_attribute<F, R>( &self, key: &OnionObject, f: &F, ) -> Result<R, RuntimeError>

where F: Fn(&OnionObject) -> Result<R, RuntimeError>,

按属性名查找元组中的键值对元素。

参数

• key: 属性名对象
• f: 处理函数，对应值作为参数

返回

• Ok(R): 查找成功，返回处理函数结果
• Err(RuntimeError): 未找到属性

pub fn binary_add( &self, other: &OnionObject, ) -> Result<OnionStaticObject, RuntimeError>

元组拼接（二元加法）。

参数

• other: 另一个元组对象

返回

拼接后的新元组对象

pub fn contains(&self, other: &OnionObject) -> Result<bool, RuntimeError>

判断元组是否包含指定对象。

参数

• other: 要查找的对象

返回

• true: 包含
• false: 不包含

impl OnionTuple

pub fn equals(&self, other: &OnionObject) -> Result<bool, RuntimeError>

Trait Implementations

impl Clone for OnionTuple

fn clone(&self) -> OnionTuple

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OnionTuple

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

Formats the value using the given formatter.

impl GCTraceable<OnionObjectCell> for OnionTuple

fn collect(&self, queue: &mut VecDeque<GCArcWeak<OnionObjectCell>>)

collects all reachable objects and adds them to the provided queue.