fileutils {tools} | R Documentation |
Utilities for testing and listing files, and manipulating file paths.
file_path_as_absolute(x) file_path_sans_ext(x) file_test(op, x, y) list_files_with_exts(dir, exts, all.files = FALSE, full.names = TRUE) list_files_with_type(dir, type, all.files = FALSE, full.names = TRUE, OS_subdirs = .OStype())
x,y |
character vectors giving file paths. |
op |
a character string specifying the test to be performed.
Unary tests (only x is used) are "-f" (existence and
not being a directory) and "-d" (existence and directory);
binary tests are "-nt" (newer than, using the modification
dates) and "-ot" . |
dir |
a character string with the path name to a directory. |
exts |
a character vector of possible file extensions. |
all.files |
a logical. If FALSE (default), only visible
files are considered; if TRUE , all files are used. |
full.names |
a logical indicating whether the full paths of the files found are returned (default), or just the file names. |
type |
a character string giving the “type” of the files
to be listed, as characterized by their extensions. Currently,
possible values are "code" (R code), "data" (data
sets), "demo" (demos), "docs" (R documentation), and
"vignette" (vignettes). |
OS_subdirs |
a character vector with the names of OS-specific
subdirectories to possibly include in the listing of R code and
documentation files. By default, the value of the environment
variable R_OSTYPE , or if this is empty, the value of
.Platform$OS.type , is used. |
file_path_as_absolute
turns a possibly relative file path
absolute, performing tilde expansion if necessary. Currently, only a
single existing path can be given.
file_path_sans_ext
returns the file paths without extensions.
(Only purely alphanumeric extensions are recognized.)
file_test
performs shell-style file tests. Note that
file.exists
only tests for existence (test -e
on
some systems) but not for not being a directory.
list_files_with_exts
returns the paths or names of the files in
directory dir
with extension matching one of the elements of
exts
. Note that by default, full paths are returned, and that
only visible files are used.
list_files_with_type
returns the paths of the files in dir
of the given “type”, as determined by the extensions recognized
by R. When listing R code and documentation files, files in
OS-specific subdirectories are included if present according to the
value of OS_subdirs
. Note that by default, full paths are
returned, and that only visible files are used.
file.path
,
file.info
,
list.files
dir <- file.path(R.home(), "library", "stats") file_test("-d", dir) file_test("-nt", file.path(dir, "R"), file.path(dir, "demo")) list_files_with_exts(file.path(dir, "demo"), "R") list_files_with_type(file.path(dir, "demo"), "demo") # the same file_path_sans_ext(list.files(file.path(R.home(), "modules")))