keep_fnames: Filter collection of filenames by name

In mclm: Mastering Corpus Linguistics Methods

Filter collection of filenames by name

Description

The functions build a subset of an object of class fnames based on a vector of characters, either including them (with keep_fnames(invert = FALSE)) or excluding them (with keep_fnames(invert = FALSE) or drop_fnames()).

Usage

keep_fnames(x, y, invert = FALSE, ...)

drop_fnames(x, y, ...)

Arguments

x	An object of class fnames, to be filtered.
y	An object of class fnames or class types or a character vector. This is the filtering criterion.
invert	Boolean value. If TRUE, the elements in y are excluded rather than kept (and keep_fnames() behaves like drop_fnames())
...	Additional arguments.

Value

An object of class fnames.

Examples

all_fnames <- as_fnames(c("file1", "file2", "file3",
                          "file4", "file5", "file6"))

unwanted_fnames <- as_fnames(c("file1", "file4"))
keep_fnames(all_fnames, unwanted_fnames, invert = TRUE)
drop_fnames(all_fnames, unwanted_fnames)

wanted_fnames <- as_fnames(c("file3", "file5"))
keep_fnames(all_fnames, wanted_fnames)

mclm documentation built on Oct. 3, 2022, 9:07 a.m.