routine rename
Documentation for routine rename
assembled from the following types:
class IO::Path
From IO::Path
(IO::Path) routine rename
Defined as:
method rename(IO::Path: IO() , : = False --> Bool)sub rename(IO() , IO() , : = False --> Bool)
Renames a file or directory. Returns True
on success; fails with X::IO::Rename if :$createonly
is True
and the $to
path already exists or if the operation failed for some other reason.
Note: some renames will always fail, such as when the new name is on a different storage device. See also: move
.