\HeaderA{findFiles}{Finds one or several files in multiple directories}{findFiles}
\keyword{file}{findFiles}
\keyword{IO}{findFiles}
\keyword{internal}{findFiles}
\begin{Description}\relax
Finds one or several files in multiple directories.
\end{Description}
\begin{Usage}
\begin{verbatim}findFiles(pattern=NULL, paths=NULL, recursive=FALSE, firstOnly=TRUE, ...)\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{pattern}] A regular expression file name pattern to match.
\item[\code{paths}] A \code{\LinkA{character}{character}} \code{\LinkA{vector}{vector}} of paths to be searched.
\item[\code{recursive}] If \code{\LinkA{TRUE}{TRUE}}, the directory structure is searched
breath-first, in lexicographic order.
\item[\code{firstOnly}] If \code{\LinkA{TRUE}{TRUE}}, the method returns as soon as a matching
file is found, otherwise not.
\item[\code{...}] Arguments passed to \code{\LinkA{list.files}{list.files}}().
\end{ldescription}
\end{Arguments}
\begin{Value}
Returns a \code{\LinkA{vector}{vector}} of the full pathnames of the files found.
\end{Value}
\begin{Section}{Paths}
The \code{paths} argument may also contain paths specified as
semi-colon (\code{";"}) separated paths, e.g.
\code{"/usr/;usr/bin/;.;"}.
\end{Section}
\begin{Section}{Windows Shortcut links}
If package \pkg{R.utils} is available, Windows Shortcut links (*.lnk)
are recognized and can be used to immitate links to directories
elsewhere.  For more details, see \code{\LinkA{filePath}{filePath}}.
\end{Section}
\begin{Author}\relax
Henrik Bengtsson (\url{http://www.braju.com/R/})
\end{Author}

