File renameTo() method in Java with examples
The renameTo() method is a part of File class. The renameTo() function is used to rename the abstract path name of a File to a given path name. The function returns true if the file is renamed else returns false
Attention reader! Don’t stop learning now. Get hold of all the important Java Foundation and Collections concepts with the Fundamentals of Java and Java Collections Course at a student-friendly price and become industry ready. To complete your preparation from learning a language to DS Algo and many more, please refer Complete Interview Preparation Course.
public boolean renameTo(File destination)
Parameters: The function requires File object destination as parameter, the new abstract path name of the present file.
Return Value: The function returns boolean data type. The function returns true the file is renamed else returns false
Exception: This method throws following exceptions:
- Security Exception if the method does not allow write operation of the abstract pathnames.
- NullPointerException if the destination filename is null.
Below programs will illustrate the use of renameTo() function:
Example 1: Try to rename the file program.txt to program1.txt
File is renamed
Example 2: Try to rename “program1.txt” to “prog.txt”, “prog.txt” is a existing file in the f: drive .
File cannot be renamed
The programs might not run in an online IDE. please use an offline IDE and set the path of the file