Skip to content

缺失、失败与错误传播 ​

查不到值和操作没有成功是两回事。用 可选<T> 表示可能没有值,用 结果<T, E> 表示操作成功或失败。调用者应先读返回类型,再选择如何处理。

返回类型分支常见场景
可选<T>存在(值)、不存在在映射中查键、读取环境变量。
结果<T, E>成功(值)、失败(错误)读文件、把字节解码成 UTF-8。
结果<可选<T>, E>成功(存在(值))、成功(不存在)、失败(错误)读一行标准输入:读到内容、正常结束、读取失败。

同时处理三个分支 ​

下面的程序只读一行。输入为空行时输出「读到空行」;标准输入已结束时输出「输入结束」;读取失败则把原因写到标准错误。

cl
主程序 {
    匹配 终端::读取行() {
        成功(可选文本) => {
            匹配 可选文本 {
                存在(文本) => {
                    如果 (文本.是否为空()) {
                        终端::输出行("读到空行");
                    } 否则 {
                        终端::输出行(文本);
                    }
                }
                不存在 => 终端::输出行("输入结束");
            }
        }
        失败(错误) => 终端::输出错误行(错误.原因);
    }
}

成功(不存在) 不是错误,成功(存在("")) 也不是输入结束。若操作来源换成映射查找,缺键同样只是 不存在,不需要构造错误。

把失败交给上层处理 ​

在返回 结果 的方法中,表达式? 在成功时取出成功值,在失败时立即从当前方法返回失败;问号之后的语句不会执行。适合当前方法没有足够信息修复错误,决定交给上层统一处理的场景。

cl
抽象 数量服务 { }

行为 数量服务 {
    方法 读取(可用: 逻辑型): 结果<整数, 字符串> {
        如果 (非 可用) { 返回 失败("数量不可用"); }
        返回 成功(12);
    }

    方法 加一(可用: 逻辑型): 结果<整数, 字符串> {
        令 数量 = 此.读取(可用)?;
        返回 成功(数量 + 1);
    }
}

主程序 {
    令 服务 = 数量服务 {};
    匹配 服务.加一(假) {
        成功(数量) => 终端::输出行(数量);
        失败(原因) => 终端::输出错误行(原因);
    }
}

上例会把「数量不可用」写入标准错误。把最后的参数改为 真,标准输出是 13。这里两个方法的错误类型都是 字符串;如果要把错误转换成另一种类型或补充上下文,请显式匹配失败分支。

查询状态与取值 ​

类型方法调用前提
可选<载荷类型>是否存在(): 逻辑型可查询任一分支。
可选<载荷类型>解包(): 载荷类型先确认是 存在。
结果<成功类型, 失败类型>是否成功(): 逻辑型可查询任一分支。
结果<成功类型, 失败类型>解包(): 成功类型先确认是 成功。
结果<成功类型, 失败类型>错误(): 失败类型先确认是 失败。

如果两条分支都需要行动,优先使用 匹配,让分支和各自的载荷同时出现在代码里。