Java.io.File.renameTo() Method

Description

The java.io.File.renameTo(File dest) method rename the file indicated by this abstract name.

Declaration

Following is the declaration for java.io.File.renameTo(File dest) method:

public boolean renameTo(File dest)

Parameters

• dest -- The new abstract pathname for this abstract pathname.

Return Value

This method returns true if the renaming succeeded, else false.

Exception

• SecurityException -- If a security manager exists and its method denies write access to either the old or new pathnames.

• NullPointerException -- If parameter destination is null.

Example

The following example shows the usage of java.io.File.renameTo(File dest) method.

package com.tutorialspoint;

import java.io.File;

public class FileDemo {
   public static void main(String[] args) {
      
      File f = null;
      File f1 = null;
      boolean bool = false;
      
      try{      
         // create new File objects
         f = new File("C:/test.txt");
         f1 = new File("C:/testABC.txt");
         
         // rename file
         bool = f.renameTo(f1);
         
         // print
         System.out.print("File renamed? "+bool);
         
      }catch(Exception e){
         // if any error occurs
         e.printStackTrace();
      }
   }
}

Let us compile and run the above program, this will produce the following result:

File renamed? true