R: File Utilities

fileutils {tools} | R Documentation

## File Utilities

### Description

Utilities for listing files, and manipulating file paths.

### Usage

    file_ext(x)
    file_path_as_absolute(x)
    file_path_sans_ext(x, compression = FALSE)

    list_files_with_exts(dir, exts, all.files = FALSE,
                         full.names = TRUE)
    list_files_with_type(dir, type, all.files = FALSE,
                         full.names = TRUE, OS_subdirs = .OStype())

### Arguments

`x` | character vector giving file paths.
`compression` | logical: should compression extension ‘.gz’, ‘.bz2’ or ‘.xz’ be removed first?
`dir` | a character string with the path name to a directory.
`exts` | a character vector of possible file extensions (excluding the leading dot).
`all.files` | a logical. If `FALSE` (default), only visible files are considered; if `TRUE`, all files are used.
`full.names` | a logical indicating whether the full paths of the files found are returned (default), or just the file names.
`type` | a character string giving the ‘type’ of the files to be listed, as characterized by their extensions. Currently, possible values are `"code"` (R code), `"data"` (data sets), `"demo"` (demos), `"docs"` (R documentation), and `"vignette"` (vignettes).
`OS_subdirs` | a character vector with the names of OS-specific subdirectories to possibly include in the listing of R code and documentation files. By default, the value of the environment variable R_OSTYPE, or if this is empty, the value of `.Platform$OS.type`, is used.

### Details

`file_ext` returns the file (name) extensions (excluding the leading dot). (Only purely alphanumeric extensions are recognized.)

`file_path_as_absolute` turns a possibly relative file path absolute, performing tilde expansion if necessary. This is a wrapper for `normalizePath`. Currently, `x` must be a single existing path.

`file_path_sans_ext` returns the file paths without extensions (and the leading dot). (Only purely alphanumeric extensions are recognized.)

`list_files_with_exts` returns the paths or names of the files in directory `dir` with extension matching one of the elements of `exts`. Note that by default, full paths are returned, and that only visible files are used.

`list_files_with_type` returns the paths of the files in `dir` of the given ‘type’, as determined by the extensions recognized by R. When listing R code and documentation files, files in OS-specific subdirectories are included if present according to the value of `OS_subdirs`. Note that by default, full paths are returned, and that only visible files are used.

### See Also

`file.path`, `file.info`, `list.files`

### Examples

    dir <- file.path(R.home(), "library", "stats")
    list_files_with_exts(file.path(dir, "demo"), "R")
    list_files_with_type(file.path(dir, "demo"), "demo") # the same
    file_path_sans_ext(list.files(file.path(R.home("modules"))))

[Package tools version 3.1.2 Index]