rmin - 一个用于编写 R 扩展的最小化 Rust 库

这是一个非常早期的版本，仅支持向量类型，因此其开销最小化。

与广为人知的 rextendr 相比，这个包尽管有一些限制，但可以提供更快的实现、更小的代码大小和更快的编译时间。

由于它足够小，你可以很容易地将这个包集成到你的 CRAN 软件包中。

状态

最近可用的版本是 v0.4.3，不要使用 GIT 版本

请注意，我对切换分支不熟悉，直接提交到主分支是非常不可信的。GitHub 只是一个仓库

v0.4.3 版本中的破坏性变化

• 创建一个（不安全的）类型 OptionSexp，因为 R 中的 MISSING(一个缺失值) 返回非零（甚至不返回，因为指针可能无效）。这不是选择，因为有了宏支持，Sexp 不能缺失，
• 在宏中统一两个入口与 lib*.so 和 *.so：创建两者。
• 你应该使用 use rmin::{*, println}; 在 std 模式下导入，否则会生成警告。因为 std::println! 不能输出到 Rgui.exe，需要显式导入来覆盖 std::println。

v0.4.0 版本即将到来的破坏性变化

character 重新绑定到 Sexp<char>，它将 SEXPTYPE 绑定到 STRSXP

版本0.3.0的character绑定移动到Rchar，因为R告诉我返回的CHARSXP类型名称为

在printf和rf_errorcall中添加额外的'%s\0'，以防止格式化错误

特性

需要以下特性之一：cfg-if(用于无_std环境)或std(用于常规使用)。

注意

请切换到 prelude 模块页面进行初步了解，因为我想要展示所有文档，大多数私有内容都使用 public-all 功能标志进行文档说明。请勿直接使用它们，因为大多数都有安全包装，直接使用它们是危险的。

用法

版本 0.1.0 提供了一种最快（但很丑）的方法，在函数上实现约 2 倍的速度提升。它们在 0.2.* 中被弃用，因为它们真的很不安全，可能会引起内存泄漏。

当前0.3.0版本与0.2.0版本略有不同，将SEXP<T>重命名为Sexp<T>，并（将）支持类似Sexp<numeric_list>(R::numeric_list)或甚至是一个任意列表Sexp<(T1,T2)>。

注意：在即将到来的0.4.0版本中，所有decl_macro可能会被移动到一个单独的crate中，该crate提供宏和proc_macros。这可能只会影响具有默认no_std环境的用户。

0.3.0，将#[no_std]恢复！

在0.3.0中，feature std再次是可选的，这将给我们更快的代码生成速度。

变更

1. • 目前，新的方法和来自（Rust类型）的方法都进入SExt，您仍然可以编写Owned<T>::new()，但返回Protected<T>。
2. • 为no_std添加一个catch_unwind。
3. • 将SEXP<T>移动到Sexp<T>，因此SEXP和Sexp可以在相同的情况下出现。
4. • 使用宏2.0隐藏大部分结构和方法，但保留文档以供调试目的。
5. • 添加对列表的支持（部分完成。）

语法

#![no_std]
use rmin::{*, println};
/// Return a+b to R.
#[no_mangle]
pub extern "C" fn add_protect(a:Sexp<f64>,b:Sexp<f64>) -> Owned<f64> {
handle_panic(||{
let mut c=Owned::new(1);
c[0]=a[0]+b[0];
c.into()
})
}
#[no_mangle]
pub extern "C" fn add_noprotect(a:Sexp<f64>,b:Sexp<f64>) -> Owned<f64> {
handle_panic(||{
let mut c=Owned::new(1);
c[0]=a[0]+b[0];
c.into()
})
}

/// raise panic.
#[no_mangle]
pub extern "C" fn panic() -> Owned<f64> {
handle_panic(||{
panic!("error occurs")
})
}

/// with macro
/// macro will register this function, thus R will check whether all parameters are missing
#[export]
fn macro_will_expand_and_register_it(a:Sexp<f64>)->Owned<f64>{
let mut b=Owned::new(1);
b[0]=a.data().sum();
}
done!();// in case you're using macros, adding a done! is necessary, this done call generate the
// register routine, which will ensure the expanded code is checked.
fn main() {} // just makes compiler happy

上述程序可以使用测试命令进行测试

export LOAD="dyn.load('target/release/examples/libcompare_rmin.so');addnp=getNativeSymbolInfo('add_noprotect');addp=getNativeSymbolInfo('add_protect');panic=getNativeSymbolInfo('panic')" ; LC_ALL=C r -e "$LOAD;system.time(sapply(1:100000,function(x)tryCatch(.Call(wrap__panic),error=I)))" 2>/dev/null ; LC_ALL=C r -e "$LOAD;system.time(sapply(1:1000000,function(x).Call(addp,1.,2.)));system.time(sapply(1:1000000,function(x).Call(addp,1.,2.)))"