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

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

【免费下载链接】uomUnits 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 文件。

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