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