外部语言函数接口

Rust 提供了到 C 语言库的外部语言函数接口（Foreign Function Interface，FFI）。外 部语言函数必须在一个 extern 代码块中声明，且该代码块要带有一个包含库名称 的 #[link] 属性。

  1. use std::fmt;
  3. // 这个 extern 代码块链接到 libm 库
  4. #[link(name = "m")]
  5. extern {
  6.     // 这个外部函数用于计算单精度复数的平方根
  7.     fn csqrtf(z: Complex) -> Complex;
  9.     // 这个用来计算单精度复数的复变余弦
  10.     fn ccosf(z: Complex) -> Complex;
  11. }
  13. // 由于调用其他语言的函数被认为是不安全的，我们通常会给它们写一层安全的封装
  14. fn cos(z: Complex) -> Complex {
  15.     unsafe { ccosf(z) }
  16. }
  18. fn main() {
  19.     // z = -1 + 0i
  20.     let z = Complex { re: -1., im: 0. };
  22.     // 调用外部语言函数是不安全操作
  23.     let z_sqrt = unsafe { csqrtf(z) };
  25.     println!("the square root of {:?} is {:?}", z, z_sqrt);
  27.     // 调用不安全操作的安全的 API 封装
  28.     println!("cos({:?}) = {:?}", z, cos(z));
  29. }
  31. // 单精度复数的最简实现
  32. #[repr(C)]
  33. #[derive(Clone, Copy)]
  34. struct Complex {
  35.     re: f32,
  36.     im: f32,
  37. }
  39. impl fmt::Debug for Complex {
  40.     fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
  41.         if self.im < 0. {
  42.             write!(f, "{}-{}i", self.re, -self.im)
  43.         } else {
  44.             write!(f, "{}+{}i", self.re, self.im)
  45.         }
  46.     }
  47. }