\Header{list.files}{List the Files in a Directory/Folder}
\alias{dir}{list.files}
\keyword{file}{list.files}
\begin{Description}\relax
This function produces a list containing the names of files
in the named directory. \code{dir} is an alias.\end{Description}
\begin{Usage}
\begin{verbatim}
list.files(path = ".", pattern=NULL, all.files=FALSE, full.names=FALSE)
       dir(path = ".", pattern=NULL, all.files=FALSE, full.names=FALSE)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{path}] a character vector of full path names.
\item[\code{pattern}] an optional regular expression.  Only file names
which match the regular expression will be returned.
\item[\code{all.files}] a logical value. If \code{FALSE}, only the
names of visible files are returned.  If \code{TRUE},
all file names will be returned.
\item[\code{full.names}] a logical value.  If \code{TRUE}, the directory
path is prepended to the file names.  If \code{FALSE}, only
the file names are returned.
\end{ldescription}
\end{Arguments}
\begin{Value}
A character vector containing the names of the files in the
specified directories, or \code{""} 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 \code{full.names = TRUE}.\end{Value}
\begin{Note}\relax
File naming conventions are very platform dependent.\end{Note}
\begin{Author}\relax
Ross Ihaka\end{Author}
\begin{SeeAlso}\relax
\code{\Link{file.info}}, \code{\Link{file.access}}
and \code{\Link{files}} for many more file handling functions.\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
list.files(R.home())
## Only files starting with a-l or r (*including* uppercase):
dir("../..", pattern = "^[a-lr]",full.names=TRUE)
\end{ExampleCode}
\end{Examples}

