在 IO::Path 中§
请参阅主要文档 在上下文中 了解常规重命名
method rename(IO::Path: IO() , : = False --> Bool)sub rename(IO() , IO() , : = False --> Bool)
重命名文件或目录。成功时返回 True；如果 :$createonly 为 True 且 $to 路径已存在或由于其他原因导致操作失败，则使用 X::IO::Rename 失败。
注意：某些重命名操作始终会失败，例如当新名称位于不同的存储设备上时。另请参见：move。