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.
# S3 method for default
renameFile(pathname, newPathname, overwrite=FALSE, ..., verbose=FALSE)
The pathname of the file to be renamed.
The new pathname.
If an existing directory and the source is a file, then the
destination becomes file.path(newPathname, basename(pathname))
.
If TRUE
and there exists a file with new pathname,
then it is overwritten.
Not used.
See Verbose
.
Returns TRUE
if the file was successfully renamed.
If it failed, an exception is thrown.
file.rename()
.