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
use std::result;
use thiserror::Error;
/// 哈希索引错误枚举
#[derive(Error, Debug)]
pub enum Error {
/// 桶数量非法（必须为 2 的幂且大于 0）
#[error("桶数量必须是 2 的幂且大于 0: {0}")]
InvalidBucketCount(usize),
/// 逻辑地址非法（0 为保留的无效地址）
#[error("逻辑地址非法 (0 为保留的无效地址): {0:#x}")]
InvalidAddress(u64),
/// 逻辑地址超过 48 位上限（最大 256TB）
#[error("逻辑地址超过 48 位限制 (最大 256TB): {0:#x}")]
AddressOverflow(u64),
/// 溢出桶内存池耗尽
#[error("溢出桶内存池已耗尽")]
OverflowPoolExhausted,
/// 溢出桶链回环检测异常
#[error("检测到哈希桶溢出链存在环或深度超过上限")]
OverflowCycleDetected,
/// 多键自旋加锁超时
#[error("多键自旋加锁超时")]
LockTimeout,
/// 操作系统直接虚拟内存分配异常
#[error(transparent)]
Mem(#[from] wbase::Error),
}
/// 哈希索引结果类型
pub type Result<T> = result::Result<T, Error>;