libPaths {base} | R Documentation |
.libPaths
gets/sets the library trees within which packages are
looked for.
.libPaths(new) .Library .Library.site
new |
a character vector with the locations of R library
trees. Tilde expansion (path.expand ) is done, and if
any element contains one of *?[ , globbing is done where
supported by the platform: see Sys.glob . |
.Library
is a character string giving the location of the
default library, the ‘library’ subdirectory of R_HOME
.
.Library.site
is a (possibly empty) character vector giving the
locations of the site libraries, by default the ‘site-library’
subdirectory of R_HOME
(which may not exist).
.libPaths
is used for getting or setting the library trees that
R knows about (and hence uses when looking for packages). If called
with argument new
, the library search path is set to
the existing directories in unique(c(new, .Library.site, .Library))
and this is returned. If given no argument, a character vector with
the currently active library trees is returned.
The library search path is initialized at startup from the environment
variable R_LIBS
(which should be a colon-separated list of
directories at which R library trees are rooted) followed by those in
environment variable R_LIBS_USER
. Only directories which exist
at the time will be included.
By default R_LIBS
is unset, and R_LIBS_USER
is set to
directory ‘R/R.version$platform-library/x.y’
of the home directory, for R x.y.z.
.Library.site
can be set via the environment variable
R_LIBS_SITE
(as a colon-separated list of library trees).
Function .libPaths
always uses the values of .Library
and .Library.site
in the base name space. .Library.site
can be set by the site in ‘Rprofile.site’, which should be
followed by a call to .libPaths(.libPaths())
to make use of the
updated value.
A character vector of file paths.
Becker, R. A., Chambers, J. M. and Wilks, A. R. (1988) The New S Language. Wadsworth & Brooks/Cole.
.libPaths() # all library trees R knows about