R libPaths 包的搜索路径

说明

.libPaths 获取/设置在其中查找包的库树。

用法

.libPaths(new, include.site = TRUE)

.Library
.Library.site

参数

new	一个字符向量，其位置为R Library 的树。波形符扩展 (path.expand) 完成，并且如果任何元素包含以下之一*?[，通配符是在平台支持的情况下完成的：请参阅Sys.glob.
include.site	一个逻辑值，指示 .Library.site 的值是否应包含在新的库树位置集中。默认为 TRUE ，当在没有 new 参数的情况下调用 .libPaths 时，它将被忽略。

细节

.Library是一个字符串，给出默认库的位置，‘ Library ’的子目录R_HOME.

.Library.site 是一个(可能为空)字符向量，给出站点库的位置。

.libPaths用于获取或设置库树R了解并因此在查找包(库搜索路径)时使用。如果带有参数调用new，默认情况下，库搜索路径设置为现有目录unique(c(new, .Library.site, .Library))并返回。如果include.site是FALSE当。。。的时候new参数已设置，.Library.site未添加到新的库搜索路径中。如果调用时没有new参数，返回具有当前活动库树的字符向量。

new 中带有尾部斜杠的路径的处理方式是OS-dependent。在 POSIX 文件系统上，现有目录通常可以用尾部斜杠指定。在 Windows 上，带有尾部斜杠(或反斜杠)的文件路径无效，并且使用尾部斜杠指定的现有目录可能不会添加到库搜索路径中。

启动时，库搜索路径从环境变量初始化R_LIBS,R_LIBS_USER和R_LIBS_SITE，如果设置应该给出目录列表，其中R库树是有根的，类 Unix 系统上为colon-separated，Windows 上为semicolon-separated。对于后两者，值为NULL表示空目录列表。 (请注意，从R4.2.0，两者均由Rstart-up 代码如果尚未设置或为空，则可以从R会话来查找它们的默认值：在早期版本中，这仅适用于R_LIBS_USER.)

第一的，.Library.site初始化自R_LIBS_SITE。如果未设置或为空，则‘site-library’的子目录R_HOME用来。仅保留初始化时存在的目录。然后，.libPaths()使用给出的目录组合来调用R_LIBS和R_LIBS_USER。默认情况下R_LIBS未设置，并且如果R_LIBS_USER未设置或为空，它被设置为目录‘右/R.版本$平台- Library /x.y类 Unix 系统上主目录的 '(或 Library /R/m/x.y/ Library ’ 对于 CRAN macOS 版本，m Sys.info()["machine"]) 和 'R/win-library/x.y’的子目录LOCALAPPDATA在 Windows 上，对于R 坐标.

两个都R_LIBS_USER和R_LIBS_SITE函数说明符的可能扩展R-version-specific 信息作为启动过程的一部分。可能的转换说明符都以‘开头⁠%⁠' 并后跟一个字母(使用 '⁠%%⁠' 获得 '⁠%⁠’)，当前可用的转换规范如下：

'⁠%V⁠’

R版本号，包括补丁级别(例如，‘⁠2.5.0⁠’)。

'⁠%v⁠’

R不包括补丁级别的版本号(例如，‘⁠2.5⁠’)。

'⁠%p⁠’

的平台R建成后，值R.version$platform.

'⁠%o⁠’

底层操作系统，R.version$os 的值。

'⁠%a⁠’

架构(CPU)R建立在/为了，的值R.version$arch.

(看version有关 R 版本信息的详细信息。)此外，‘⁠%U⁠' 和 '⁠%S⁠’ 扩展到R默认值分别为R_LIBS_USER和R_LIBS_SITE.

函数.libPaths总是使用的值.Library和.Library.site在基本命名空间中。.Library.site可以由站点设置‘Rprofile.site’，之后应该调用.libPaths(.libPaths())使用更新后的值。

为了保持一致性，路径始终按 normalizePath(winslash = "/") 进行标准化。

LOCALAPPDATA(通常C:\Users\username\AppData\Local) 在 Windows 上是隐藏目录，某些软件可能无法查看。它可以通过以下方式打开shell.exec(Sys.getenv("LOCALAPPDATA")).

值

文件路径的字符向量。

例子

.libPaths()                 # all library trees R knows about

参考

Becker, R. A., Chambers, J. M. and Wilks, A. R. (1988) The New S Language. Wadsworth & Brooks/Cole.

也可以看看

library