R.utils (version 1.16.0)

findFiles: Finds one or several files in multiple directories

Description

Finds one or several files in multiple directories.

Usage

## S3 method for class 'default':
findFiles(pattern=NULL, paths=NULL, recursive=FALSE, firstOnly=TRUE, allFiles=TRUE, ...)

Arguments

pattern
A regular expression file name pattern to match.
paths
A character vector of paths to be searched.
recursive
If TRUE, the directory structure is searched breath-first, in lexicographic order.
firstOnly
If TRUE, the method returns as soon as a matching file is found, otherwise not.
allFiles
If FALSE, files and directories starting with a period will be skipped, otherwise not.
...
Arguments passed to list.files().

Value

  • Returns a vector of the full pathnames of the files found.

Search path

The paths argument may also contain paths specified as semi-colon (";") separated paths, e.g. "/usr/;usr/bin/;.;".

Windows Shortcut links

Windows Shortcut links (*.lnk) are recognized and can be used to immitate links to directories elsewhere. For more details, see filePath().