getDLLRegisteredRoutines        package:base        R Documentation

_R_e_f_l_e_c_t_a_n_c_e _I_n_f_o_r_m_a_t_i_o_n _f_o_r _C/_F_o_r_t_r_a_n _r_o_u_t_i_n_e_s _i_n _a _D_L_L

_D_e_s_c_r_i_p_t_i_o_n:

     This function allows us to query the set of routines in a DLL that
     are registered with R to enhance dynamic lookup, error handling
     when calling native routines, and potentially security in the
     future. This function provides a description of each of the
     registered routines in the DLL for the different interfaces, i.e.
     '.C', '.Call', '.Fortran' and '.External'.

_U_s_a_g_e:

     getDLLRegisteredRoutines(dll, addNames = TRUE)

_A_r_g_u_m_e_n_t_s:

     dll: a character string or 'DLLInfo' object (as returned by
          'getLoadedDLLs'). 

addNames: a logical value. If this is 'TRUE', the elements of the
          returned lists are named using the names of the routines (as
          seen by R via registration or raw name).  If 'FALSE', these
          names are not computed and assigned to the lists.  As a
          result, the call should be quicker.  The name information is
          also available in the 'NativeSymbolInfo' objects in the
          lists. 

_D_e_t_a_i_l_s:

     This takes the registration information after it has been
     registered and processed by the R internals. In other words, it
     uses the extended information

_V_a_l_u_e:

     A list with four elements corresponding to the routines registered
     for the .C, .Call, .Fortran and .External interfaces. Each element
     is a list with as many elements as there were routines registered
     for that interface. Each element identifies a routine and is an
     object of class 'NativeSymbolInfo'. An object of this class has
     the following fields: 

    name: the registered name of the routine (not necessarily the name
          in the C code).

 address: the memory address of the routine as resolved in the loaded
          DLL. This may be 'NULL' if the symbol has not yet been
          resolved.

     dll: an object of class 'DLLInfo' describing the DLL. This is same
          for all elements returned.

numParameters: the number of arguments the native routine is to be
          called with. In the future, we will provide information about
          the types of the parameters also. 

_A_u_t_h_o_r(_s):

     Duncan Temple Lang <duncan@wald.ucdavis.edu>

_R_e_f_e_r_e_n_c_e_s:

     "Writing R Extensions Manual" for symbol registration. R News,
     Volume 1/3, September 2001.   "In search of C/C++ & Fortran
     Symbols"

_S_e_e _A_l_s_o:

     'getLoadedDLLs'

_E_x_a_m_p_l_e_s:

     dlls <- getLoadedDLLs()
     getDLLRegisteredRoutines(dlls[["base"]])

     getDLLRegisteredRoutines("stats")

