Метод renameTo

Метод renameTo класса File переименовывает файл или директорию. В первый параметр мы передаем объект File, который представляет новое имя (или новый путь) для текущего файла. Метод возвращает true, если переименование прошло успешно, и false в противном случае.

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

Синтаксис

file.renameTo(newFile)

Пример

Давайте создадим файл и переименуем его:

import java.io.File;
import java.io.IOException;

public class Main
{
	public static void main(String[] args)
	{
		try
		{
			File oldFile = new File("oldName.txt");
			File newFile = new File("newName.txt");
			
			if (oldFile.createNewFile())
			{
				System.out.println("File created: " + oldFile.getName());
			}
			
			boolean res = oldFile.renameTo(newFile);
			
			System.out.println("Rename successful: " + res);
			System.out.println("Old file exists: " + oldFile.exists());
			System.out.println("New file exists: " + newFile.exists());
			System.out.println("New file name: " + newFile.getName());
		}
		catch (IOException e)
		{
			System.out.println("An error occurred.");
		}
	}
}

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

"File created: oldName.txt"
"Rename successful: true"
"Old file exists: false"
"New file exists: true"
"New file name: newName.txt"

Пример

Давайте попробуем переименовать файл, который не существует:

import java.io.File;

public class Main
{
	public static void main(String[] args)
	{
		File oldFile = new File("nonExistentFile.txt");
		File newFile = new File("newName.txt");
		
		boolean res = oldFile.renameTo(newFile);
		
		System.out.println("Rename successful: " + res);
	}
}

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

"Rename successful: false"

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

класс File,
который представляет файл или директорию
метод exists,
который проверяет существование файла
метод createNewFile,
который создает новый пустой файл
метод delete,
который удаляет файл или директорию