.GGobiCall {Rggobi} | R Documentation |
The .ggobi.symbol
function is used entirely within R to
map the given name to the name of the corresponding
C routine.
The other two functions – .GGobiC
and .GGobiCall
–
convert the name and then call their C invocation counterparts.
These functions map the simple name of a C routine into the package-specific version of that name. These allow use to hide the use a name textit{mangling} scheme of our choosing for the C level routines in the shared library/DLL that provides the glue between R and ggobi. This is useful for avoiding name conflicts with other C code in R or other packages. These are only of relevance to the developers of this package and those working with its C code.
.GGobiCall(name, ..., .gobi=getDefaultGGobi()) .GGobiC(name, ..., .gobi=getDefaultGGobi()) .ggobi.symbol(name)
name |
the simple name of the C routine to be resolved |
... |
the arguments that to be passed to the .C or .Call |
.gobi |
the ggobi instance identifier that is to be passed to the C routine as its last argument. Specifying this here helps to ensure it is not omitted. |
The mapping of the name to its corresponding C routine name
is done in conjunction with the pre-processor macro
RS_GGOBI
. These must be synchronized.
.ggobi.symbol
returns the name of the C routine
corresponding to its argument.
The .GGobiC
and .GGobiCall
functions invoke the C
routine corresponding to the specified name and return the same result
as the corresponding .C
and .Call
do.
Duncan Temple Lang
http://www.ggobi.org/RSggobi.html