const_sizes
友好可读的 2 的幂次常量大小(power-of-two size constants),对标 Linux 内核 <linux/sizes.h> 的 SZ_* 宏。
#![no_std]、零依赖、纯 pub const usize,可在裸机 / 嵌入式 / 内核场景直接使用。
为什么需要它
写裸机或内核代码时,到处充斥 0x1000、0x10_0000、16 * 1024 这类魔数:
const KERNEL_HEAP: usize = 16 * 1024 * 1024; // 多少?数 0
const PAGE_SIZE: usize = 0x1000; // 4K?还是别的?
换成 const_sizes 之后语义自解释、计算在编译期完成、不会写错位数:
use ;
const KERNEL_HEAP: usize = SZ_16M;
const PAGE_SIZE: usize = SZ_4K;
用法
把依赖加到 Cargo.toml:
[]
= "0.1"
直接按需 use:
use ;
// 缓存行
;
// 页大小
const PAGE_SIZE: usize = SZ_4K;
// 大页
const HUGE_PAGE: usize = SZ_2M;
// 用户空间上限
const USER_SPACE_END: usize = SZ_1G;
常量列表
单位均为 power-of-two binary(1K = 1024,1M = 1 048 576,1G = 1 073 741 824)。
| 区间 | 常量 |
|---|---|
| 字节 | SZ_1 SZ_2 SZ_4 SZ_8 SZ_16 SZ_32 SZ_64 SZ_128 SZ_256 SZ_512 |
| KiB | SZ_1K SZ_2K SZ_4K SZ_8K SZ_16K SZ_32K SZ_64K SZ_128K SZ_256K SZ_512K |
| MiB | SZ_1M SZ_2M SZ_4M SZ_8M SZ_16M SZ_32M SZ_64M SZ_128M SZ_256M SZ_512M |
| GiB | SZ_1G SZ_2G SZ_4G |
注:
- 全部为
pub const usize,可用于数组长度、const表达式、#[repr(align(...))]等任意 const 上下文。 SZ_4G在 32 位 target 上不可用(usize装不下),仅 64 位平台有效。
MSRV
跟随 workspace 声明的 rust-version,当前为 1.95。
License
Apache-2.0,见仓库根目录 LICENSE。