R语言【base】——system.file() 在软件包等中查找文件的完整文件名。

Package base version 4.3.2

---

Parameters

system.file(..., package = "base", lib.loc = NULL,
            mustWork = FALSE)

参数【...】：字符向量，指定某个软件包中的子目录和文件。默认情况下，没有值则返回软件包的根目录。不支持通配符。

参数【package】：是一个字符串，包含一个软件包的名称。如果给出的软件包名称超过一个，则会发生错误。

参数【lib.loc】：一个字符向量，包含 R 语言库的路径名。

参数【mustWork】：逻辑。如果为 TRUE，则在没有匹配文件的情况下出错。

使用 file.exists 检查指定文件是否存在。因此，只有在有足够权限确定文件存在的情况下，才会返回文件路径。 

参数【...】中的未命名参数通常是字符串，但如果是字符向量，则会循环使用直到长度相同。

它会使用 find.package 查找软件包，因此在默认 lib.loc = NULL 的情况下，会首先查找附加软件包，然后在 .libPaths() 中列出的每个库中查找。请注意，如果已加载命名空间但未附加软件包，则只能通过 .libPaths() 查找。

---

Value

长度为正的字符向量，包含与参数【...】匹配的文件路径，如果没有匹配，则为空字符串""（除非 mustWork = TRUE）。

如果匹配的是软件包根目录，则没有尾部分隔符。

system.file() 不带参数，会给出 base 软件包的根目录。

---

Examples

system.file()                  
system.file(package = "stats") 
system.file("INDEX")
system.file("help", "AnIndex", package = "splines")