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)
Returns TRUE
if the file was successfully renamed.
If it failed, an exception is thrown.
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
.
Henrik Bengtsson
file.rename()
.