Learn R Programming
R.utils (version 2.3.0)

renameFile: Renames a file (or a directory) atomically/safely

Description

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.

Usage

"renameFile"(pathname, newPathname, overwrite=FALSE, ..., verbose=FALSE)

Arguments

pathname
The pathname of the file to be renamed.
newPathname
The new pathname. If an emphexisting 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().