umx (version 4.20.0)

umx_rename_file: Rename files

Description

Rename files. On OS X, the function can access the current front-most Finder window. The file renaming is fast and, because you can use regular expressions too change names.

Usage

umx_rename_file(
  findStr = "old",
  replaceStr = NA,
  baseFolder = "Finder",
  test = TRUE,
  ignoreSuffix = TRUE,
  listPattern = NULL,
  overwrite = FALSE
)

Value

None

Arguments

findStr

The pattern to find, i.e., "cats"

replaceStr

The replacement pattern "\1 are not dogs"

baseFolder

Folder to search in. Default ("Finder") will use the current front-most Finder window (on MacOS). Set to NA for a "choose folder" dialog.

test

Boolean determining whether to change files on disk, or just report on what would have happened (Defaults to test = TRUE)

ignoreSuffix

Whether to ignore (don't search in) the suffix (file-type like .mpg) TRUE.

listPattern

A pre-filter for files

overwrite

Boolean determining if an existing file will be overwritten (Defaults to the safe FALSE)

See Also

Other File Functions: dl_from_dropbox(), umx_file_load_pseudo(), umx_make_sql_from_excel(), umx_move_file(), umx_open(), umx_write_to_clipboard(), umx

Examples

if (FALSE) {
# "Season 01" --> "S01" in current folder in MacOS Finder
umx_rename_file("[Ss]eason +([0-9]+)", replaceStr="S\\1", test = TRUE)

# move date to end of file name
umx_rename_file("^(.*) *([0-9]{2}\\.[0-9]{2}\\.[0-9]+) *(.*)", replaceStr="\\1 \\3 \\2")

}