list.files               package:base               R Documentation

List the Files in a Directory/Folder

Description:

     This function produces a list containing the names of files in the
     named directory. 'dir' is an alias.

Usage:

     list.files(path = ".", pattern = NULL, all.files = FALSE,
                full.names = FALSE, recursive = FALSE)
            dir(path = ".", pattern = NULL, all.files = FALSE,
                full.names = FALSE, recursive = FALSE)

Arguments:

    path: a character vector of full path names; the default
          corresponds to the working directory 'getwd()'.

 pattern: an optional regular expression.  Only file names which match
          the regular expression will be returned.

all.files: a logical value. If 'FALSE', only the names of visible files
          are returned.  If 'TRUE', all file names will be returned.

full.names: a logical value.  If 'TRUE', the directory path is
          prepended to the file names.  If 'FALSE', only the file names
          are returned.

recursive: logical. Should the listing recurse into directories?

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'.

Note:

     File naming conventions are very 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.

Examples:

     list.files(R.home())
     ## Only files starting with a-l or r (*including* uppercase):
     dir("../..", pattern = "^[a-lr]",full.names=TRUE)

