library.dynam {base} | R Documentation |
Load the specified file of compiled code if it has not been loaded already.
library.dynam(chname, package = .packages(), lib.loc = NULL, verbose = getOption("verbose"), file.ext, ...) .dynLibs(new)
chname |
a character string naming a shared library to load. |
package |
a character vector with the names of packages to search through. |
lib.loc |
a character vector describing the location of R
library trees to search through, or NULL . The default value
of NULL corresponds to all libraries currently known. |
verbose |
a logical value indicating whether an announcement is printed on the console before loading the shared library. The default value is taken from the verbose entry in the system options. |
file.ext |
the extension to append to the file name to specify the library to be loaded. This defaults to the appropriate value for the operating system. |
... |
additional arguments needed by some libraries that
are passed to the call to dyn.load to control
how the library is loaded. |
new |
a character vector of packages which have loaded shared libraries. |
This is designed to be used inside a package rather than at the
command line, and should really only be used inside
.First.lib()
. The system-specific extension
for shared libraries
(e.g., `.so' or `.sl' on Unix systems)
should not be added.
.dynLibs
is used for getting or setting the packages that have
loaded shared libraries (using library.dynam
). Versions of R
prior to 1.6.0 used an internal global variable .Dyn.libs
for
storing this information: this variable is now defunct.
library.dynam
returns a character vector with the names of
packages which have used it in the current R session to load shared
libraries. This vector is returned as invisible
, unless
the chname
argument is missing.
.First.lib
, library
,
dyn.load
, .packages
,
.libPaths
SHLIB
for how to create suitable shared libraries.
library.dynam()# which packages have been ``dynamically loaded''