get_filename {mintyr} | R Documentation |
Extract Filenames from File Paths
Description
The get_filename
function extracts filenames from file paths with options to remove file extensions
and/or directory paths.
Usage
get_filename(paths, rm_extension = TRUE, rm_path = TRUE)
Arguments
paths |
A |
rm_extension |
A
|
rm_path |
A
|
Details
The function performs the following operations:
Validates input paths
Handles empty input vectors
Optionally removes directory paths using
basename
Optionally removes file extensions using regex substitution
Value
A character
vector of processed filenames with applied transformations.
Note
If both
rm_extension
andrm_path
are FALSE, a warning is issued and the original paths are returnedSupports multiple file paths in the input vector
See Also
-
base::basename()
for basic filename extraction
Examples
# Example: File path processing demonstrations
# Setup test files
xlsx_files <- mintyr_example(
mintyr_examples("xlsx_test") # Get example Excel files
)
# Example 1: Extract filenames without extensions
get_filename(
xlsx_files, # Input file paths
rm_extension = TRUE, # Remove file extensions
rm_path = TRUE # Remove directory paths
)
# Example 2: Keep file extensions
get_filename(
xlsx_files, # Input file paths
rm_extension = FALSE, # Keep file extensions
rm_path = TRUE # Remove directory paths
)
# Example 3: Keep full paths without extensions
get_filename(
xlsx_files, # Input file paths
rm_extension = TRUE, # Remove file extensions
rm_path = FALSE # Keep directory paths
)