umx (version 4.0.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, powerful.

Usage

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

Arguments

findStr

The (regex) string to find, i.e., "cat"

replaceStr

The (regex) replacement string "\1 are not dogs"

baseFolder

The folder to search in. If set to "Finder" (and you are on OS X) it will use the current front-most Finder window. If it is blank, a choose folder dialog will be thrown.

ignoreSuffix

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

listPattern

A pre-filter for files

test

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

overwrite

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

Value

None

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

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