Rustler使用 Rust 编写 Erlang NIF 库
Rustler 实现了用安全的 Rust 代码编写 Erlang NIF 的库。 这意味着应该没有办法让BEAM(Erlang VM)崩溃。 该库提供了用于生成样板的工具,用于与BEAM交互,处理Erlang术语的编码和解码,并在它们展开到C之前捕获 Rust 错误。
Erlang 的 NIF(Native Implemented Function)被用来扩展erlang的某些功能,一般用来实现一些erlang很难实现的,或者一些erlang实现效率不高的功能。
NIF使用C开发,效率和C接近,比纯erlang实现要高。NIF会编译成动态库,直接动态加载到erlang进程空间调用,也是erlang扩展新方法最高效的做法。调用NIF不用上下文的切换开销,但是也有代价,NIF的crash会导致整个Erlang进程crash。
该库提供了 Erlang 和 Elixir 的功能,但目前 Elixir 更受欢迎。
特性:
- 安全 - The code you write in a Rust NIF should never be able to crash the BEAM.
- 互操作 - Decoding and encoding rust values into Erlang terms is as easy as a function call.
- 类型组合 - Making a Rust struct encodable and decodable to Erlang or Elixir can be done with a single attribute.
- 资源对象 - Enables you to safely pass a reference to a Rust struct into Erlang code. The struct will be automatically dropped when it's no longer referenced.
开始使用
最简单的入门是使用 rustler elixir library.
- 为你的项目添加 rustler elixir library 依赖
- 运行
mix rustler.new
生成一个新的 NIF
注意: 如果你以前用过 Rustler, 你需要先运行 mix archive.uninstall rustler_installer.ez
来移除之前生成的 NIF。
示例代码:
use rustler::{Encoder, Env, Error, Term}; mod atoms { rustler::rustler_atoms! { atom ok; } } rustler::rustler_export_nifs!( "Elixir.Math", [ ("add", 2, add) ], None ); fn add<'a>(env: Env<'a>, args: &[Term<'a>]) -> Result<Term<'a>, Error> { let a: i64 = args[0].decode()?; let b: i64 = args[1].decode()?; Ok((atoms::ok(), a + b).encode(env)) }
评论