.Call
,
.C
, .Fortran
, or
.External
). Additionally, it returns the address of the
symbol and this can be passed to other C routines. Specifically, this
provides a way to explicitly share symbols between different
dynamically loaded package libraries. Also, it provides a way to
query where symbols were resolved, and aids diagnosing strange
behavior associated with dynamic resolution.
getNativeSymbolInfo(name, PACKAGE, unlist = TRUE, withRegistrationInfo = FALSE)
"base"
, we search in the R executable itself.unlist
is TRUE
and the number of symbol names in
name
is one, then the NativeSymbolInfo
object
is returned. If it is FALSE
, then a list
of NativeSymbolInfo
objects is returned.
This is ignored if the number of symbols passed in name
is
more than one.
To be compatible with earlier versions of this function, this
defaults to TRUE
.
TRUE
, to return information that was registered with R about
the symbol and its parameter types if such information is available,
or if FALSE
to return just the address of the symbol.
name
argument.withRegistrationInfo
is FALSE
,
this is the native memory address of the symbol which can
be used to invoke the routine, and also to
compare with other symbol addresses. This is an external pointer
object and of class NativeSymbol
.
If withRegistrationInfo
is TRUE
and registration
information is available for the symbol, then this is
an object of class RegisteredNativeSymbol
and is a reference
to an internal data type that has access to the routine pointer and
registration information. This too can be used in calls to
.Call
, .C
, .Fortran
and
.External
.
PACKAGE
argument in
the different native interface functions..Call
, etc.).
If the symbol has been explicitly registered by the DLL
in which it is contained, information about the number of arguments
and the interface by which it should be called will be returned.
Otherwise, a generic native symbol object is returned.
getDLLRegisteredRoutines
,
is.loaded
,
.C
,
.Fortran
,
.External
,
.Call
,
dyn.load
.