dart:io

Метод rename

Переименовывает этот файл.

Возвращает Future<File>, который завершается File переименованного файла.

Если newPath — это относительный путь, он разрешается относительно текущей рабочей директории (Directory.current). Это означает, что простое изменение имени файла, но сохранение исходной директории, требует создания нового полного пути с новым именем в конце. Пример:

Future<File> changeFileNameOnly(File file, String newFileName) {
  var path = file.path;
  var lastSeparator = path.lastIndexOf(Platform.pathSeparator);
  var newPath = path.substring(0, lastSeparator + 1) + newFileName;
  return file.rename(newPath);
}

На некоторых платформах операция переименования не может перемещать файл между различными файловыми системами. В этом случае вместо этого скопируйте файл в новое местоположение, а затем удалите оригинал.

Если newPath идентифицирует существующий файл, этот файл удаляется в первую очередь. Если newPath идентифицирует существующую директорию, операция завершается неудачей, а будущее завершается исключением.

Реализация

Future<File> rename(String newPath);