高级主题

外部函数接口

在Rust中，通过外部函数接口 (foreign function interface) 可以直接调用C语言库：

  1. extern crate libc;
  2. use libc::size_t;
  4. #[link(name = "snappy")]
  5. extern {
  6.     fn snappy_max_compressed_length(source_length: size_t) -> size_t;
  7. }
  9. fn main() {
  10.     let x = unsafe { snappy_max_compressed_length(100) };
  11.     println!("max compressed length of a 100 byte buffer: {}", x);
  12. }

其中#[link]属性用来指示链接器链接snappy库，extern块是外部库函数标记的列表。
外部函数被假定为不安全的，所以调用它们需要包装在unsafe块中。

当然，我们也可以把Rust代码编译为动态库来供其它语言调用：

  1. // in embed.rs
  2. use std::thread;
  4. #[no_mangle]
  5. pub extern "C" fn process() {
  6.     let handles: Vec<_> = (0..10).map(|_| {
  7.         thread::spawn(|| {
  8.             let mut _x = 0;
  9.             for _ in (0..5_000_001) {
  10.                 _x += 1
  11.             }
  12.         })
  13.     }).collect();
  15.     for h in handles {
  16.         h.join().ok().expect("Could not join a thread!");
  17.     }
  18. }

其中#[no_mangle]属性用来关闭Rust的命名改编，
默认的应用二进制接口 (application binary interface) "C"可以省略。
然后使用rustc进行编译：

  1. $ rustc embed.rs -O --crate-type=dylib

这将生成一个动态库libembed.so。在Node.js中调用该函数，需要安装ffi库：

  1. $ npm install ffi
  1. // in test.js
  2. var ffi = require('ffi');
  4. var lib = ffi.Library('libembed', {
  5.   'process': [ 'void', [] ]
  6. });
  8. lib.process();
  10. console.log("done!");

其中ffi.Library()用来加载动态库libembed.so，
它需要标明外部函数的返回值类型和参数类型 (空数组表明没有参数)。