findFiles

0th

Percentile

Finds one or several files in multiple directories

Finds one or several files in multiple directories.

Keywords
internal, file, IO
Usage
# S3 method for 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, subdirectories are recursively processed, and not if FALSE. Alternatively, the maximum recursive depth can be specified as a non-negative numeric, where FALSE corresponds to 0L depth and TRUE corresponds +Inf depth.

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/;.;".

Recursive searching

Recursive searching of directory structure is done breath-first in a lexicographic order.

Windows Shortcut links

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

Aliases
  • findFiles.default
  • findFiles
Documentation reproduced from package R.utils, version 2.8.0, License: LGPL (>= 2.1)

Community examples

Looks like there are no examples yet.