this.path (version 2.5.0)

ext: File Extensions

Description

splitext() splits an extension from a path.

removeext() removes an extension from a path.

ext() gets the extension of a path.

ext<-() sets the extension of a path.

Usage

splitext(path, compression = FALSE)
removeext(path, compression = FALSE)
ext(path, compression = FALSE)
ext(path, compression = FALSE) <- value

Value

for splitext(), a matrix with 2 rows and

length(path) columns. The first row will be the roots of the paths, the second row will be the extensions of the paths.

for removeext() and ext(), a character vector the same length as path.

for ext<-(), the updated object.

Arguments

path

character vector, containing path names.

compression

should compression extensions ".gz", ".bz2", and ".xz" be taken into account when removing / / getting an extension?

value

a character vector, typically of length 1 or length(path), or NULL.

Details

Tilde-expansion (see ?path.expand()) of the path will be performed.

Trailing path separators are removed before dissecting the path.

Except for path <- NA_character_, it will always be true that path == paste0(removeext(path), ext(path)).

Examples

splitext(character(0))
splitext("")

splitext("file.ext")

path <- c("file.tar.gz", "file.tar.bz2", "file.tar.xz")
splitext(path, compression = FALSE)
splitext(path, compression = TRUE)

path <- "this.path_2.5.0.tar.gz"
ext(path) <- ".png"
path

path <- "this.path_2.5.0.tar.gz"
ext(path, compression = TRUE) <- ".png"
path