Friday, April 3, 2026
HomeLanguagesJavaFile renameTo() method in Java with examples

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

Function Signature:

public boolean renameTo(File destination)

Syntax:

file.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




// Java program to demonstrate
// the use of File.renameTo() method
  
import java.io.*;
  
public class GFG {
  
    public static void main(String args[])
    {
        // create an abstract pathname (File object)
        File f = new File("F:\\program.txt");
  
        // create the destination file object
        File dest = new File("F:\\program1.txt");
  
        // check if the file can be renamed
        // to the abstract path name
        if (f.renameTo(dest)) {
  
            // display that the file is renamed
            // to the abstract path name
            System.out.println("File is renamed");
        }
        else {
            // display that the file cannot be renamed
            // to the abstract path name
            System.out.println("File cannot be renamed");
        }
    }
}


Output:

File is renamed

Example 2: Try to rename “program1.txt” to “prog.txt”, “prog.txt” is a existing file in the f: drive .




// Java program to demonstrate
// the use of File.renameTo() method
  
import java.io.*;
  
public class GFG {
    public static void main(String args[])
    {
        // create an abstract pathname (File object)
        File f = new File("F:\\program1.txt");
  
        // create the destination file object
        File dest = new File("F:\\prog.txt");
  
        // check if the file can be renamed
        // to the abstract path name
        if (f.renameTo(dest)) {
  
            // display that the file is renamed
            // to the abstract path name
            System.out.println("File is renamed");
        }
        else {
            // display that the file cannot be renamed
            // to the abstract path name
            System.out.println("File cannot be renamed");
        }
    }
}


Output:

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

RELATED ARTICLES

3 COMMENTS

Most Popular

Dominic
32512 POSTS0 COMMENTS
Milvus
131 POSTS0 COMMENTS
Nango Kala
6886 POSTS0 COMMENTS
Nicole Veronica
12006 POSTS0 COMMENTS
Nokonwaba Nkukhwana
12100 POSTS0 COMMENTS
Shaida Kate Naidoo
7015 POSTS0 COMMENTS
Ted Musemwa
7259 POSTS0 COMMENTS
Thapelo Manthata
6972 POSTS0 COMMENTS
Umr Jansen
6960 POSTS0 COMMENTS