【libm】0库入口文件（lib.rs）

一、源码

lib.rs是libm（纯 Rust 实现的数学函数库）的入口文件。

1. //! libm in pure Rust
3. #![no_std]
4. #![cfg_attr(intrinsics_enabled, allow(internal_features))]
5. #![cfg_attr(intrinsics_enabled, feature(core_intrinsics))]
6. #![cfg_attr(all(intrinsics_enabled, target_family = "wasm"), feature(wasm_numeric_instr))]
7. #![cfg_attr(f128_enabled, feature(f128))]
8. #![cfg_attr(f16_enabled, feature(f16))]
9. #![allow(clippy::assign_op_pattern)]
10. #![allow(clippy::deprecated_cfg_attr)]
11. #![allow(clippy::eq_op)]
12. #![allow(clippy::excessive_precision)]
13. #![allow(clippy::float_cmp)]
14. #![allow(clippy::int_plus_one)]
15. #![allow(clippy::many_single_char_names)]
16. #![allow(clippy::mixed_case_hex_literals)]
17. #![allow(clippy::needless_late_init)]
18. #![allow(clippy::needless_return)]
19. #![allow(clippy::unreadable_literal)]
20. #![allow(clippy::zero_divided_by_zero)]
21. #![forbid(unsafe_op_in_unsafe_fn)]
24. mod libm_helper;
25. mod math;
27. use core::{f32, f64};
30. pub use libm_helper::*;
32. pub use self::math::*;

复制代码

• 文件注释
  

1. //! libm in pure Rust

复制代码

//! 是模块级文档注释，说明这个库是一个纯 Rust 实现的 libm（数学函数库）。

• 全局属性（#![…]）
  #![no_std]
  

• 声明该库不依靠 Rust 标准库（std），适用于嵌入式体系或无操纵体系的环境。
  

#![cfg_attr(intrinsics_enabled, ...)]

• 条件编译：如果 intrinsics_enabled 特性启用，则答应使用内部特性（internal_features）和 core_intrinsics（编译器内置函数）。
  
• 对 WASM 目标额外启用 wasm_numeric_instr（WASM 数字指令优化）。
  

#![cfg_attr(f128_enabled, feature(f128))]

• 如果 f128_enabled 启用，则启用实验性的 f128（128 位浮点数）支持（Rust 尚未稳定此功能）。
  

#![cfg_attr(f16_enabled, feature(f16))]

• 如果 f16_enabled 启用，则启用实验性的 f16（16 位浮点数）支持。
  

• Clippy 忽略规则
  

1. #![allow(clippy::assign_op_pattern)]
2. #![allow(clippy::deprecated_cfg_attr)]
3. ...
4. #![allow(clippy::zero_divided_by_zero)]

复制代码

• 禁用 Clippy（Rust 的代码风格查抄工具）的某些告诫，比方：
  
  
  
  • float_cmp：答应浮点数直接比较（数学库需要）。
    
  • unreadable_literal：答应长数字字面量（如 3.14159265358979323846）。
    
  • zero_divided_by_zero：答应 0.0 / 0.0（数学库需要处理 NaN）。
    
  
  

• 安全限制
  

1. #![forbid(unsafe_op_in_unsafe_fn)]

复制代码

• 强制在 unsafe fn 中明确标志 unsafe 代码块（提高安全性）。
  

• 模块声明
  

1. mod libm_helper;
2. mod math;

复制代码

• 定义两个子模块：
  
  
  
  • libm_helper：可能包含辅助函数或宏。
    
  
  

• math：核心数学函数实现（如 sin、sqrt）。
  
• 导入依靠
  

1. use core::{f32, f64};

复制代码

• 从 core 库导入 f32 和 f64 类型（no_std 环境下替换 std 的浮点类型）。
  

• 公开 API
  

1. pub use libm_helper::*;
2. pub use self::math::*;

复制代码

• 将 libm_helper 和 math 模块的所有公共项（函数/类型）导出为库的公共 API。
  

二、关键点总结

• 纯 Rust 实现：不依靠 std，恰当嵌入式或无 OS 环境。
  
• 条件编译：支持 WASM、f16/f128 等实验性功能。
  
• 数学函数：核心逻辑在 math 模块中实现（如 sin、exp）。
  
• 安全优先：严格限制 unsafe 的使用。
  

三、示例：如何使用 libm

1. use libm::{sqrt, sin};
3. fn main() {
4.     println!("sqrt(2.0) = {}", sqrt(2.0_f64)); // 1.4142135623730951
5.     println!("sin(PI/2) = {}", sin(1.5707963267948966_f64)); // ~1.0
6. }

复制代码

这个库的设计目标是在不依靠体系 libm 的环境下提供标准数学函数，同时保持高性能和安全性。

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。