Changes the name of a file; an existing file NEWNAME will be clobbered. Returns true for success; on failure returns false and sets$!.
Behavior of this function varies wildly depending on your system implementation. For example, it will usually not work across file system boundaries, even though the systemmv command sometimes compensates for this. Other restrictions include whether it works on directories, open files, or pre-existing files. Checkperlport and either therename(2) manpage or equivalent system documentation for details.
For a platform independentmove function look at theFile::Copy module.
Portability issues:"rename" in perlport.
Perldoc Browser is maintained by Dan Book (DBOOK). Please contact him via theGitHub issue tracker oremail regarding any issues with the site itself, search, or rendering of documentation.
The Perl documentation is maintained by the Perl 5 Porters in the development of Perl. Please contact them via thePerl issue tracker, themailing list, orIRC to report any issues with the contents or format of the documentation.