R语言【base】——list.files()：生成命名目录中文件或目录名称的字符向量

Package base version 4.2.0

---

Parameters

list.files(path = ".", pattern = NULL, all.files = FALSE,
           full.names = FALSE, recursive = FALSE,
           ignore.case = FALSE, include.dirs = FALSE, no.. = FALSE)

dir(path = ".", pattern = NULL, all.files = FALSE,
           full.names = FALSE, recursive = FALSE,
           ignore.case = FALSE, include.dirs = FALSE, no.. = FALSE)

list.dirs(path = ".", full.names = TRUE, recursive = TRUE)

参数【path】：完整路径名称的字符向量；默认值对应于工作目录 getwd()。执行 波浪展开（参见 path.expand）。缺失的值将被忽略。带有标记编码的元素将被转换为本机编码（如果转换失败，则视为不存在）。

参数【pattern】：可选正则表达式。只返回与正则表达式匹配的文件名。

参数【all.files】：逻辑值。如果 FALSE，则只返回可见文件的名称（遵循unix风格的可见性，即文件名不以点开头的文件）。如果为 TRUE，则返回所有文件名。

参数【full.names】：逻辑值。如果为 TRUE，则将目录路径附加到文件名之前以给出相对文件路径。如果为 FALSE，则返回文件名（而不是路径）。

参数【recursive】：逻辑值。清单应该递归到目录中吗？

参数【ignore.case】：逻辑值。模式匹配应该不区分大小写吗？

参数【include.dirs】：逻辑值。子目录名应该包含在递归清单中吗？（它们总是在非递归类型中）。

参数【no..】：逻辑值。“.” 和 “..” 也应该从非递归列表中排除吗？

---

Value

包含指定目录中文件名称的字符向量（如果没有文件则为空）。如果路径不存在或不是目录或不可读，则跳过该路径。

如果 full.names = TRUE，则文件按字母顺序在完整路径上排序。

list.dirs 隐式地使用了 files = TRUE，如果 recursive = TRUE，则结果包括参数【path】本身（前提是它是可读目录）。

dir 是 list.files 的别名。

---

Note

文件命名约定依赖于平台。模式匹配适用于操作系统返回的文件名的大小写。

参数【path】必须指定可以在当前代码页中表示的路径，并且参数【path】下的文件名不能在该代码页中表示的文件/目录很可能找不到。