| list.files {base} | R Documentation |
List the Files in a Directory/Folder
Description
These functions produce a character vector of the names of files in the named directory.
Usage
list.files(path = ".", pattern = NULL, all.files = FALSE,
full.names = FALSE, recursive = FALSE,
ignore.case = FALSE)
dir(path = ".", pattern = NULL, all.files = FALSE,
full.names = FALSE, recursive = FALSE,
ignore.case = FALSE)
Arguments
path |
a character vector of full path names; the default
corresponds to the working directory |
pattern |
an optional regular expression. Only file names which match the regular expression will be returned. |
all.files |
a logical value. If |
full.names |
a logical value. If |
recursive |
logical. Should the listing recurse into directories? |
ignore.case |
logical. Should pattern-matching be case-insensitive? |
Value
A character vector containing the names of the files in the
specified directories, or "" if there were no files. If a
path does not exist or is not a directory or is unreadable it
is skipped, with a warning.
The files are sorted in alphabetical order, on the full path
if full.names = TRUE. Directories are included only if
recursive = FALSE.
Note
File naming conventions are platform dependent.
recursive = TRUE is not supported on all platforms and may be
ignored (with a warning).
Author(s)
Ross Ihaka, Brian Ripley
See Also
file.info, file.access
and files for many more file handling functions and
file.choose
for interactive selection.
glob2rx to convert wildcards (as used by system file
commands and shells) to regular expressions.
Sys.glob for wildcard expansion on file paths.
Examples
list.files(R.home())
## Only files starting with a-l or r
## Note that a-l is locale-dependent, but using case-insensitive
## matching makes it unambiguous in English locales
dir("../..", pattern = "^[a-lr]",full.names=TRUE, ignore.case = TRUE)