renameSync 抽象方法

File renameSync(
  1. String newPath
)
override

同步重命名此文件。

返回重命名文件的新 File 对象。

如果 newPath 是相对路径,则相对于当前工作目录 (Directory.current) 进行解析。这意味着仅更改文件名但保留原始目录,则需要创建一个新的完整路径,并在末尾添加新名称。示例

File changeFileNameOnlySync(File file, String newFileName) {
  var path = file.path;
  var lastSeparator = path.lastIndexOf(Platform.pathSeparator);
  var newPath = path.substring(0, lastSeparator + 1) + newFileName;
  return file.renameSync(newPath);
}

在某些平台上,重命名操作不能在不同的文件系统之间移动文件。如果是这种情况,请先使用 copySync 将文件复制到新位置,然后使用 deleteSync 删除原始文件。

如果 newPath 指定了一个现存的文件或链接,那么该实体首先被删除。如果 newPath 指定了一个现存的目录,该操作将抛出 FileSystemException

实现

File renameSync(String newPath);