1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
//! 兼容派生宏(compatible derive macro)的第一版配套支持接口(support interface)。
//!
//! 本模块(module)仅供生成代码(generated code)使用,不是手写业务代码的稳定入口。
//! 支持协议(support protocol)的版本独立于上游 `thiserror` 的补丁版本(patch version);
//! 同一支持协议(support protocol)内保持签名(signature)和行为相容。
//!
//! 借用转换(borrow conversion)不分配、不复制被借用对象,不增加线程安全约束;
//! 格式化(formatting)和提供者(provider)转发保留被调用实现的成本、失败和副作用。
//! 本模块(module)自身不启动线程、不执行输入输出(I/O),也不捕获回溯(backtrace)。
//!
//! 接口(interface)语义参照 `thiserror 2.0.18` 的 `aserror`、`display`、`var`、
//! `provide`;这里的来源版本不是依赖版本约束(dependency version constraint)。
use fmt;
pub use Error;
pub use Backtrace;
// 支持协议(support protocol)只包含原始对象的借用视图(borrowed view)及标准转发。
// AsDynError 不改变错误身份或对象生命期;AsDisplay 在显示时才执行标准格式化。
// Var 和 ThiserrorProvide 只委托 Pointer/provide,原样保留失败和用户实现的副作用。
// sealed 约束与实现关系在本模块(module)内维护,不向调用方开放自定义支持协议的入口。
// 两个源文件经 include! 组成同一逻辑模块(logical module),不是相互依赖的两个模块。
// 关键声明、实现关系和方法签名固定;配对文件仅填写相应方法体。
/// 把已有错误借用为标准错误对象(standard error object)。
///
/// 返回借用(borrow)的有效期不超过 `self`,不会延长对象生命期或取得所有权(ownership)。
/// 不要求 `Send`、`Sync` 或 `'static`;具体约束由后续消费者决定。
/// 合法输入由封闭特征(sealed trait)实现集限定,无运行期(runtime)非法值分支。
/// 时间与额外空间均为 O(1),无分配、同步、格式化(formatting)或用户回调(callback)。
/// 提供可显示视图(displayable view),保留原始借用(borrow)。
///
/// 普通 `Display` 对象返回其引用;`Path` 与 `PathBuf` 返回标准路径显示视图。
/// 生成视图(view)本身为 O(1) 时间和额外空间,不分配、不读取文件系统(filesystem)。
/// 后续显示(display)的成本及副作用由实际格式化实现和输出目标决定。
/// 指针格式化(pointer formatting)的借用包装(borrowed wrapper)。
///
/// 唯一字段保存共享借用(shared borrow),不复制、不解引用原始指针(raw pointer)。
/// `Pointer` 实现必须转发给被包装对象,而不是打印本包装的地址,并原样返回 `fmt::Result`。
/// 构造为 O(1);显示成本、分配、阻塞及恐慌(panic)行为继承被调用的 `Pointer` 实现。
/// 自动特征(auto trait)由 `&T` 决定,不额外承诺被借用对象可跨线程使用。
;
/// 在夜间版(nightly)上转发标准错误提供者(standard error provider)请求。
///
/// 只在当前库包(crate)启用 `error_generic_member_access` 时编译。
/// 请求(request)可借用或复制提供的数据;数据生命期和所有权(ownership)服从标准协议。
/// 本接口(interface)不自行缓存、捕获回溯(backtrace)或改变错误来源链(source chain)。
/// 成本、重入(reentrancy)、阻塞和恐慌(panic)行为继承被调用的 `Error::provide`。
include!;