ns-lowlev                package:base                R Documentation

_L_o_w _L_e_v_e_l _N_a_m_e _S_p_a_c_e _S_u_p_p_o_r_t _F_u_n_c_t_i_o_n_s

_D_e_s_c_r_i_p_t_i_o_n:

     Low level name space support functions.

_U_s_a_g_e:

     attachNamespace(ns, pos = 2)
     loadNamespace(package, lib.loc = NULL,
                   keep.source = getOption("keep.source.pkgs"),
                   partial = FALSE, declarativeOnly = FALSE)
     loadedNamespaces()
     unloadNamespace(ns)
     loadingNamespaceInfo()
     saveNamespaceImage(package, rdafile, lib.loc = NULL,
                        keep.source = getOption("keep.source.pkgs"))

_A_r_g_u_m_e_n_t_s:

      ns: string or namespace object.

     pos: integer specifying position to attach.

 package: string naming the package/name space to load.

 lib.loc: character vector specifying library search path.

keep.source: logical specifying whether to retain source.

 partial: logical; if true, stop just after laoding code.

declarativeOnly: logical; disables '.Import', etc, if true.

_D_e_t_a_i_l_s:

     The functions 'loadNamespace' and 'attachNamespace' are usually
     called implicitly when 'library' is used to load a name space and
     any imports needed.  However it may be useful to call these
     functions directly at times.

     'loadNamespace' loads the specified name space and registers it in
     an internal data base.  A request to load a name space that is
     already loaded has no effect.  The arguments have the same meaning
     as the corresponding arguments to 'library'.  After loading,
     'loadNamespace' looks for a hook function named '.onLoad' as  an
     internal variable in the name space (it should not be exported).
     This function is called with the same arguments as '.First.lib'. 
     Partial loading is used so support installation with the '--save'
     option.

     'loadNamespace' does not attach the name space it loads to the
     search path.  'attachNamespace' can be used to attach a frame
     containing the exported values of a name space to the search path.
     The hook function '.onAttach' is run after the name space exports
     are attached, but this is not likely to be useful.  Shared library
     loading and setting of options should be handled at load time by
     the '.onLoad' hook.

     'loadedNamespaces' returns a character vector of the names of the
     loaded name spaces.

     'unloadNamespace' can be used to force a name space to be
     unloaded.  An error is signaled if the name space is imported by
     other loaded name spaces.  If defined, a hook function
     '.onUnload', analogous to '.Last.lib', is run before removing the
     name space from the internal registry. 'unloadNamespace' will
     first 'detach' a package of the same name if one is on the path,
     thereby running a '.Last.lib' function in the package if one is
     exported.

     'loadingNamespaceInfo' returns a list of the arguments that would
     be passed to '.onLoad' when a name space is being loaded. An error
     is signaled of a name space is not currently being loaded.

     'saveNamespaceImage' is used to save name space images for
     packages installed with '--save'.

_A_u_t_h_o_r(_s):

     Luke Tierney

