[dependencies]
uom = {
    version = "0.36.0",
    default-features = false,
    features = [
        "autoconvert", # automatic base unit conversion.
        "usize", "u8", "u16", "u32", "u64", "u128", # Unsigned integer storage types.
        "isize", "i8", "i16", "i32", "i64", "i128", # Signed integer storage types.
        "bigint", "biguint", # Arbitrary width integer storage types.
        "rational", "rational32", "rational64", "bigrational", # Integer ratio storage types.
        "complex32", "complex64", # Complex floating point storage types.
        "f32", "f64", # Floating point storage types.
        "si", "std", # Built-in SI system and std library support.
        "serde", # Serde support.
    ]
}

• autoconvert -- 功能，用于启用二进制运算符中基本单位之间的自动转换。禁用此功能仅允许具有相同基本单位的数量直接交互。该功能的存在是为了解决编译器限制，其中对于非浮点型底层存储类型不会生成零成本代码。
• usize、u8、u16、u32、u64、u128、isize、i8、i16、i32、i64、i128、bigint、biguint、rational、rational32、rational64、bigrational、complex32、complex64、f32、f64 -- 功能，用于启用底层存储类型。必须至少启用这些功能中的一个。默认启用 f32 和 f64。有关选择不同底层存储类型的影响，请参阅 设计 部分。
• si -- 功能，用于包含预构建的 国际单位制 (SI)。默认启用。
• std -- 功能，用于编译时带有标准库支持。禁用此功能将使用 no_std 编译 uom。默认启用。
• serde -- 功能，用于启用对 Serde crate 中的数量序列化和反序列化的支持。默认禁用。它取代了已弃用的 use_serde 功能，该功能将在未来的 uom 版本（v0.37.0 或更高版本）中删除。

设计

与 测量单位（米、千米、英尺、英里、...）不同，uom 与 量（长度、质量、时间、...）一起工作。这简化了使用，因为单位仅在接口边界处涉及：其余代码只需关注涉及的量。这也使得对量的操作（+、-、*、/、...）在运行时没有成本，超过使用原始存储类型（例如 f32）。

uom 将数值归一化到该数量的基本单位。可以通过执行为数量系统定义的宏来使用替代的基本单位（对于国际单位制，使用 ISQ!）。uom 支持以下底层存储类型：usize、u8、u16、u32、u64、u128、isize、i8、i16、i32、i64、i128、bigint、biguint、rational、rational32、rational64、bigrational、complex32、complex64、f32 和 f64。

将数值归一化到基本单位的一个后果是，对于浮点数和有理数底层存储类型，某些值可能无法表示或无法精确表示。例如，如果 length 的基本单位是 meter，而底层存储类型是 i32，那么像 1 centimeter 或 1.1 meter 这样的值就无法表示。 1 centimeter 被归一化为 0.01 meter，这无法存储在 i32 中。uom 只允许安全地使用单位。使用此库的用户仍需要了解底层存储类型的实现细节，包括限制和精度。

贡献

欢迎每个人贡献。提交一个拉取请求、一个问题或仅对现有项目添加评论。国际度量衡局（BIPM） 是一个国际标准化组织，发布了SI小册子。本文件定义了SI，并可作为 uom 变更的全面参考。非SI单位的转换系数可以在NIST特别出版物811中找到。

除非您明确表示，否则根据Apache-2.0许可证定义，任何有意提交给您的工作的贡献，应以下列方式双重许可，不附加任何额外条款或条件。

许可证

以下任一许可证下：

• Apache许可证，版本2.0（LICENSE-APACHE 或 https://apache.ac.cn/licenses/LICENSE-2.0）
• MIT许可证（LICENSE-MIT 或 https://open-source.org.cn/licenses/MIT）

任选其一。