.GGobiCall {Rggobi}R Documentation

Wrappers for calling C routines in the R-ggobi library.

Description

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.

Usage

.GGobiCall(name, ..., .gobi=getDefaultGGobi())
.GGobiC(name, ..., .gobi=getDefaultGGobi())
.ggobi.symbol(name)

Arguments

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.

Details

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.

Value

.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.

Author(s)

Duncan Temple Lang

References

http://www.ggobi.org/RSggobi.html

See Also

.C .Call

Examples



[Package Rggobi version 1.1-2 Index]