prepCIF: Create interface template for invoking compiled routines with...

In omegahat/Rffi: Interface to libffi to dynamically invoke arbitrary compiled routines at run-time without compiled bindings

Create interface template for invoking compiled routines with a given signature

Description

This function creates a compiled object that can be used to dynamically invoke a native/compiled routine from within R but without having to explicitly program that invocation in C code. The object can be used to invoke any compiled routine with the specified signature. A signature is

Usage

prepCIF(retType, argTypes = list(),
        mutable = ans@pointerParameters,
        abi = FFI_DEFAULT_ABI, ans = new("CIF"))

Arguments

retType	an object describing the type of the return value
argTypes	a list of objects specifying the type of each of the parameters. If there is only one argument, the type can be specified directly without putting it in a list.
mutable	a logical vector, numeric vector or character vector of parameter names identifying which of the parameters are potentially mutated/changed by the routine and so should be returned.
abi	the type of application binary interface. This can be stdcall and fastcall on some platforms. It is very rare to specify this and requires deep understanding of the nature of the calls on the particular platform
ans	the CIF object that will be returned with the slots filled in. This is a parameter to allow the caller specify a more specific sub-class.

Value

An object of class (or sub-class) CIF.

Author(s)

Duncan Temple Lang

References

libffi \& its tutorial at http://sourceware.org/libffi/

See Also

callCIF

Examples

 void = CIF(voidType)
 callCIF(void, "voidCall")

 cif = CIF(doubleType, list(sint32Type, doubleType))
 callCIF(cif, "foo", -1L, pi)

   # use this CIF in another call.
 callCIF(cif, "foo", 10L, pi)

   # and call a different routine with the same signature
 callCIF(cif, "otherFoo", 10L, pi)

omegahat/Rffi documentation built on Nov. 29, 2023, 12:48 a.m.