R语言观察日志(part18)--.C和.Call

学习笔记，仅供参考，有错必纠

文章目录

.C(外来函数接口)
- 描述
- 用法
- 参数
- 细节
- 返回值
- 参数类型
- 注意
.Call(C/C++代码的接口)
- 描述
- 用法
- 参数
- 细节
- 返回值

.C(外来函数接口)

描述

函数调用已经加载到R中的编译代码。

用法

.C(.NAME, ..., NAOK = FALSE, DUP = TRUE, PACKAGE, ENCODING)
.Fortran(.NAME, ..., NAOK = FALSE, DUP = TRUE, PACKAGE, ENCODING)

参数

参数	解释
`.NAME`	一个字符串，给出`C函数`或`Fortran子例程`名称，或类"NativeSymbolInfo"、“RegisteredNativeSymbol”，"NativeSymbol"的对象。
…	传递给外部函数的参数
`NAOK`	如果为真，则参数中的任何`NA`、`NaN`或`Inf`值都被传递给外部函数。如果为假，`NA`、`NaN`或`Inf`值的存在被认为是错误。
`PACKAGE`	如果提供，将搜索字符串`.NAME`限制在此参数指定的DLL中，这是为了增加包的安全性，通过使用这个参数可以确保没有其他包可以覆盖它们的外部符号，同时也加快了搜索速度
`DUP,ENCODING`	对于向后兼容性，接受但忽略。

细节

这些函数可以用来调用编译后的C和Fortran代码。后来的接口是.Call和.External，它们更加灵活，性能更好。

这些函数都是原始的，.NAME总是与提供的第一个参数相匹配

其他被命名的参数如下…所以不能缩写。为了清晰起见，应该避免在传递给…的实参中使用名称，匹配或部分匹配.NAME。

返回值

类似于…传入的参数列表(包括给参数的任何名称)，但反映C或Fortran代码所做的任何更改。

参数类型

R参数的类型映射到C或Fortran参数的类型是：

R	C	Fortran
integer	int *	integer
numeric	double *	double precision
– or –	float *	real
complex	Rcomplex *	double complex
logical	int *	integer
character	char **	[see below]
raw	unsigned char *	not allowed
list	SEXP *	not allowed
other	SEXP	not allowed

注意

如果要经常使用这些函数之一，一定要指定PACKAGE(将搜索限制在单个DLL中)或将.NAME作为本机符号对象之一传递。

你可能会看到PACKAGE = "base"表示链接到R中的符号。

不要在你自己的代码中使用这个符号：这些符号不是API的一部分，可能在没有警告的情况下被改变。

.Call(C/C++代码的接口)

描述

函数将R对象传递给已编译的C/C++代码，该代码已加载到R中。

用法

.Call(.NAME, ..., PACKAGE)
.External(.NAME, ..., PACKAGE)

参数

参数	解释
`.NAME`	一个字符串，它给出了一个C函数的名字，或者类"NativeSymbolInfo"， “RegisteredNativeSymbol”，"NativeSymbol"的对象来指代这样的名字。
`...`	传递给编译代码的参数
`PACKAGE`	如果提供，将搜索字符串.NAME限制在此参数指定的DLL中；这一参数引出`…`因此它的名字不能缩写；这是为了增加包的安全性，通过使用这个参数可以确保没有其他包可以覆盖它们的外部符号，同时也加快了搜索速度。

细节

这些函数用于调用编译后的代码，这些代码使用内部R对象，并将参数作为R对象的序列传递给代码。它们采用C调用约定，因此通常也可用于c++代码。

返回值

在编译后的代码中构造的R对象。