.GGobiCall              package:Rggobi              R Documentation

_W_r_a_p_p_e_r_s _f_o_r _c_a_l_l_i_n_g _C _r_o_u_t_i_n_e_s _i_n _t_h_e _R-_g_g_o_b_i _l_i_b_r_a_r_y.

_D_e_s_c_r_i_p_t_i_o_n:

     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.

_U_s_a_g_e:

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

_A_r_g_u_m_e_n_t_s:

    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.

_D_e_t_a_i_l_s:

     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.

_V_a_l_u_e:

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

_A_u_t_h_o_r(_s):

     Duncan Temple Lang

_R_e_f_e_r_e_n_c_e_s:

     <URL: http://www.ggobi.org/RSggobi.html>

_S_e_e _A_l_s_o:

     '.C' '.Call'

_E_x_a_m_p_l_e_s:

