错误处理
结果/可选的精确语义、三条强制检查规则、错误传播 ?、错误码全表、运行时错误通道。
结果<T, E> 与 可选<T>
| 类型 | 构造 | 检查 | 取值 |
|---|---|---|---|
结果<T, 整32> | 正常(值) / 错误(码) | .正常(布尔) | 正常分支内 .值;失败分支 .错误 |
可选<T> | 某些(值) / 无(常量·写作 返回 无;无 无值() 构造器) | .有值(布尔) | 有值分支内 .值 |
主.cnCN
函数 找值(整32 编号) -> 可选<字符串> {
如果 编号 == 1 {
返回 某些("甲");
}
返回 无;
}
函数 主() -> 整32 {
可选<字符串> 甲 = 找值(2);
如果 甲.有值 {
打印行(甲.值);
} 否则 {
打印行("无值路径");
}
返回 0;
}输出:无值路径
三条强制检查规则(编译期)
| 规则 | 内容 | 诊断示例 |
|---|---|---|
| ① 禁丢弃 | 结果/可选 返回值当裸语句=错误 | 返回值被丢弃未检查(须用 结果.正常 检查后处理两个分支) |
| ② 禁未检取值 | 未检查 .正常 直接访问 .值=错误 | 访问 结果.值 前必须检查 结果.正常 |
| ③ 检查器数据流 | 链式 x().值、跨语句守卫跟踪(检查状态=变量属性,遮蔽声明 kill) | 同上,含行定位 |
- 守卫跟踪是流敏感的:
如果 (x.正常) { 用 x.值; }合法;x = f();重新赋值后检查状态重置。 - 复合条件不受守卫:
如果 (a.正常 && b.正常)内取a.值会被拒(保守方向)——分开嵌套写。
禁丢弃.cn(负例·编译拒绝)CN
导入 容器::向量;
函数 主() -> 整32 {
向量<整64> 表 = 向量<整64>();
表.追加(1); // ✗ 编译错误:返回值被丢弃未检查
返回 0;
}错误传播:后缀 ?
表达式?:正常/有值→取 .值 继续;失败→构造错误结果从当前函数返回(须函数返回类型兼容)。Rust ? 同构。
主.cnCN
函数 底层(整32 v) -> 结果<整32, 整32> {
如果 v < 0 { 返回 错误(6); }
返回 正常(v * 2);
}
函数 中层(整32 v) -> 结果<整32, 整32> {
整32 值 = 底层(v)?;
返回 正常(值 + 1);
}
函数 顶层(整32 v) -> 结果<整32, 整32> {
整32 值 = 中层(v)?;
返回 正常(值);
}
函数 主() -> 整32 {
结果<整32, 整32> 好 = 顶层(5);
如果 好.正常 {
打印("链式好: ", 好.值);
} 否则 { }
结果<整32, 整32> 坏 = 顶层(-1);
如果 坏.正常 { } 否则 {
打印("链式坏: ", 坏.错误);
}
返回 0;
}输出:链式好: 11 链式坏: 6
? 与三元的词法消歧后缀
?(优先级13)与三元 ?: 按同层 : 配对前瞻区分——? 后同层存在配对 : 判三元,否则判传播;a ? -b : c 无需加括号。错误码全表(附录 B)
| 码 | 枚举成员 | 典型来源 |
|---|---|---|
| 1 | 错误码.除零 | 整数除零(运行期) |
| 2 | 错误码.越界 | 数组/容器下标越界;字符串字节下标越界 |
| 3 | 错误码.空指针 | 空指针解引用 |
| 4 | 错误码.内存 | 分配失败(容器扩容等) |
| 5 | 错误码.文件 | 文件打开/读写失败;标准输入 EOF |
| 6 | 错误码.参数 | 无效参数(解析失败/越界实参);断言失败 |
| 7 | 错误码.未初始化 | 读取未初始化数据(如空栈弹出/映射未命中) |
| 8 | 错误码.溢出 | 运行期算术溢出(+ - */自增自减/复合赋值)、整MIN / -1 与 整MIN 一元取负、变量移位量超宽 |
| 9 | —(运行时输出·未入枚举) | 栈溢出:深递归耗尽线程栈 → 确定性终止(安全/不安全区同拦;手工线程须先调用 cn_install_thread_stack_guard) |
运行时错误(码)内置:打印运行时错误(错误码N): 消息并终止进程(退出码 1)——标准库「直读越界即中止」就是它。- 错误码 8 的触发面(
不安全函数内不插检查):运行期算术溢出、整MIN / -1、整MIN一元取负、变量移位量 ≥ 位宽——常量面溢出/移位超宽=编译期硬错误(不产生退出码);确需回绕用回绕加/回绕减/回绕乘。 - 入口退出码:
主返回结果<整32, E>时,正常 → 退出码取.值;失败 → 退出码取.错误(Rust Termination 同构;.值非数值的结果形态=编译期诊断)。 - 栈溢出防线(错误码 9)的实现性质:进程级信号兜底——运行时入口一次性安装,零热路径开销(不在函数体内插任何栈检查);判据=故障地址与栈指针比邻的指纹匹配,匹配不到=不拦截(恢复平台默认崩溃,宁漏勿误、不作承诺);
不安全函数内同样生效(防线面向整个进程)。安装与手工线程细节见命令行参考·环境。 - win 崩溃诊断(
[crash]/[veh]系列带寄存器与回溯)仅未处理异常时输出到 stderr,正常启动零输出。