uom：革命性单位测量库，让 dimensional analysis 零成本实现类型安全

uom：革命性单位测量库，让 dimensional analysis 零成本实现类型安全

【免费下载链接】uom Units of measurement -- type-safe zero-cost dimensional analysis 项目地址: https://gitcode.com/gh_mirrors/uo/uom

uom（Units of measurement）是一个为 Rust 开发者打造的革命性单位测量库，它通过类型安全的方式实现了零成本的 dimensional analysis（量纲分析）。无论是处理长度、质量、时间等基本物理量，还是进行复杂的单位转换和运算，uom 都能确保代码在编译时就避免单位不匹配的错误，彻底告别因单位转换失误导致的程序崩溃或数据错误。

为什么选择 uom？告别单位错误的终极解决方案 🛠️

在科学计算、工程开发或任何涉及物理量的编程场景中，单位错误是一个常见且危险的问题。例如，将长度单位误作质量单位进行运算，或者在不同单位制之间转换时出现疏漏，都可能导致严重后果——就像历史上著名的“火星气候轨道器”事故，正是由于英制单位和公制单位的混淆而造成了数亿美元的损失。

uom 从根本上解决了这个问题：

• 类型安全：通过 Rust 的类型系统在编译时检查单位合法性，杜绝单位不匹配的运算
• 零成本抽象：所有单位检查和转换在编译时完成，运行时无额外性能开销
• 丰富的单位系统：内置国际单位制（SI）及多种物理量，支持自定义单位系统
• 灵活的存储类型：支持从基本整数、浮点数到复杂数、大整数等多种存储类型

快速上手：5 分钟实现类型安全的单位运算 ⚡

1. 安装与配置

在 Cargo.toml 中添加依赖：

[dependencies]
uom = "0.38.0"

默认情况下，uom 启用 f32、f64 浮点数支持和国际单位制（SI）。你也可以根据需求自定义特性：

uom = {
    version = "0.38.0",
    default-features = false,
    features = ["si", "f64", "serde"]
}

2. 基本用法示例

下面的代码展示了如何使用 uom 进行安全的单位运算：

extern crate uom;

use uom::si::f64::*;
use uom::si::length::kilometer;
use uom::si::time::second;

fn main() {
    // 创建带单位的物理量
    let length = Length::new::<kilometer>(5.0);  // 5 千米
    let time = Time::new::<second>(15.0);        // 15 秒
    
    // 合法运算：速度 = 长度 / 时间
    let velocity = length / time;                // 结果自动推导为速度单位 (km/s)
    
    // 类型安全检查：编译时阻止单位不匹配的运算
    // let error = length + time;  // 编译错误：无法将长度和时间相加
    
    // 单位转换：获取以纳米秒为单位的时间值
    let time_in_ns = time.get::<uom::si::time::nanosecond>();
}

3. 核心功能模块探秘

uom 的核心功能通过以下模块实现：

• si 模块：src/si/ 包含国际单位制的所有物理量定义，如长度（length.rs）、时间（time.rs）、质量（mass.rs）等
• quantity 模块：src/quantity.rs 定义了 Quantity 类型，是所有物理量的基础
• unit 模块：src/unit.rs 处理单位定义和转换逻辑
• system 模块：src/system.rs 提供单位系统的创建和管理功能

高级特性：打造定制化单位系统 🚀

uom 不仅提供了现成的国际单位制，还支持创建自定义单位系统。通过 system! 宏，你可以定义自己的基本单位和导出量，满足特定领域的需求。

例如，创建一个包含自定义长度单位的系统：

// 自定义单位系统示例（简化版）
system! {
    quantities: [length, time, mass];
    units: [
        length: meter(m, "m"), foot(ft, "ft", 0.3048), inch(in, "in", 0.0254);
        time: second(s, "s");
        mass: kilogram(kg, "kg");
    ];
}

uom 还支持多种存储类型，包括：

• 基本数值类型：u8、i32、f64 等
• 大整数和有理数：bigint、bigrational
• 复数：complex32、complex64

实战案例：从示例中学习最佳实践 📚

uom 提供了丰富的示例代码，展示了不同场景下的用法：

• 基础用法：examples/base.rs 展示单位创建和基本运算
• 国际单位制：examples/si.rs 演示 SI 单位系统的完整功能
• 单位转换：examples/unit.rs 展示不同单位间的转换技巧

安装指南：快速集成到你的项目中 📦

要在项目中使用 uom，只需执行以下步骤：

1. 克隆仓库：

git clone https://gitcode.com/gh_mirrors/uo/uom

2. 在 Cargo.toml 中添加依赖（见上文安装配置部分）

3. 在代码中引入 uom：

extern crate uom;
use uom::si::f64::*;  // 导入 SI 单位系统和 f64 存储类型

总结：重新定义单位安全的 Rust 库 🌟

uom 凭借其类型安全、零成本抽象和丰富的功能，成为 Rust 生态中处理单位测量的首选库。无论是科学计算、工程应用还是日常编程，uom 都能帮助开发者避免单位错误，提高代码可靠性和可维护性。

如果你正在寻找一个既能保证单位安全又不牺牲性能的解决方案，uom 绝对是你的不二之选。立即尝试，体验类型安全的单位运算带来的开发效率提升吧！

注：uom 采用双许可证发布（Apache-2.0 和 MIT），详细信息见项目根目录下的 LICENSE-APACHE 和 LICENSE-MIT 文件。

【免费下载链接】uom Units of measurement -- type-safe zero-cost dimensional analysis 项目地址: https://gitcode.com/gh_mirrors/uo/uom