# 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 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.

file.rename().