Spec-Zone.ru › Dart 2

dart:io

rename абстрактный метод

Future<File> rename(
  1. String newPath
)
переопределение

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

Возвращает 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 завершается с исключением.

Реализация

Future<File> rename(String newPath);

© 2012 the Dart project authors
Licensed under the BSD 3-Clause "New" or "Revised" License.
https://api.dart.dev/stable/2.19.6/dart-io/File/rename.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API