renameFile

0th

Percentile

Renames a file (or a directory) atomically/safely

Renames a file (or a directory) atomically/safely, by also asserting that it was successfully renamed without side effects. If failing to rename and overwrite an existing file, the original file is kept.

Keywords
internal
Usage
# S3 method for default
renameFile(pathname, newPathname, overwrite=FALSE, ..., verbose=FALSE)
Arguments
pathname

The pathname of the file to be renamed.

newPathname

The new pathname. If an existing directory and the source is a file, then the destination becomes file.path(newPathname, basename(pathname)).

overwrite

If TRUE and there exists a file with new pathname, then it is overwritten.

...

Not used.

verbose

See Verbose.

Value

Returns TRUE if the file was successfully renamed. If it failed, an exception is thrown.

See Also

file.rename().

Aliases
  • renameFile.default
  • renameFile
Documentation reproduced from package R.utils, version 2.8.0, License: LGPL (>= 2.1)

Community examples

jonathan987 at Sep 9, 2017 R.utils v2.5.0

When you want to renames a file (or a directory) atomically/safely, by also asserting that it was successfully renamed without side effectsI use Batch Rename Files Tool. You can easily found hier BatchRenameFiles.org