Функция rename

Функция rename переименовывает файл или директорию. Она также может использоваться для перемещения файла или директории в другое место, если новое имя содержит путь. Первым параметром функция принимает текущий путь к файлу или директории, а вторым - новое имя или новый путь. Функция возвращает io::Result: Ok при успешном выполнении и Err в случае ошибки.

Синтаксис

std::fs::rename(from, to)

Пример

Давайте переименуем файл "old.txt" в "new.txt":

use std::fs;

fn main()
{
	let res = fs::rename("old.txt", "new.txt");
	println!("{:?}", res);
}

Результат выполнения кода:

Ok(())

Пример

Давайте переместим файл "abcde.txt" в директорию "folder", указав новый путь:

use std::fs;

fn main()
{
	let res = fs::rename("abcde.txt", "folder/abcde.txt");
	println!("{:?}", res);
}

Результат выполнения кода:

Ok(())

Пример

Давайте попробуем переименовать несуществующий файл "missing.txt" и посмотрим на ошибку:

use std::fs;

fn main()
{
	let res = fs::rename("missing.txt", "new.txt");
	println!("{:?}", res);
}

Результат выполнения кода:

Err(Os { code: 2, kind: NotFound, message: "No such file or directory" })

Смотрите также

функция copy,
которая копирует файл в новое место
функция remove_file,
которая удаляет файл
функция remove_dir,
которая удаляет пустую директорию
функция create_dir,
которая создаёт новую директорию