docs(core): correct public execution and ownership contracts

This commit is contained in:
2026-11-15 19:19:39 +08:00
parent 57cd32eb5c
commit ecba02c20e
3 changed files with 14 additions and 10 deletions
+3 -1
View File
@@ -44,11 +44,13 @@ impl Vm {
}
/// 宿主参数检查委托 Store,统一源码/原生数量区间并扣除已绑定接收者。
/// None 表示未发布数量元数据,不能仅凭此结果断定该对象可以调用。
pub fn call_arity(&self, function: ObjectRef) -> Result<Option<objects::CallArity>, VmError> {
self.objects.call_arity(function)
}
/// 宿主初始化 Function 名义类型配置,Store 保存弱引用用于后续函数分配。
/// 同一身份可重复设置,配置后不能换成另一类型;存活由宿主根或已附着对象等其他拥有图保证。
pub fn set_function_type(&mut self, definition: ObjectRef) -> Result<(), VmError> {
self.objects.set_function_type(definition)
}
@@ -198,7 +200,7 @@ impl Vm {
/// 嵌入方创建空 Store 和空执行状态;不注册类型、函数或语言全局空间。
pub fn new() -> Result<Self, VmError> {
// 空状态与 Store::new 保持一致,执行时按需建立全局空间与帧。
// 空状态与 Store::new 保持一致;对象/环境由调用方显式分配,执行入口按需准备帧。
Ok(Self {
objects: ObjectStore::new()?,
last_traceback: Vec::new(),