You are viewing the version of this documentation from Perl 5.005_04. View the latest version

Changes the name of a file. Returns 1 for success, 0 otherwise. 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 system mv command sometimes compensates for this. Other restrictions include whether it works on directories, open files, or pre-existing files. Check perlport and either the rename(2) manpage or equivalent system documentation for details.