Java File renameTo()方法及示例

renameTo() 方法是File类的一部分。renameTo()函数用于将一个文件的抽象路径名重命名为一个给定的路径名。如果文件被重命名，该函数返回真，否则返回假。

函数签名

public boolean renameTo(File destination)

语法

file.renameTo(File destination)

参数： 该函数需要File object destination作为参数，即当前文件的新抽象路径名称。

返回值 ：该函数返回布尔数据类型。该函数返回true，文件被重命名，否则返回false。

异常： 该方法会抛出以下异常。

如果该方法不允许对抽象路径名进行写操作，则出现 安全异常 。
如果目标文件名为空，则抛出 NullPointerException 。

下面的程序将说明renameTo()函数的使用。

例1： 尝试将文件program.txt重命名为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");
        }
    }
}

输出

File is renamed

例2： 尝试将 “program1.txt “重命名为 “prog.txt”，”prog.txt “是f: 驱动器中的一个现有文件。

// 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");
        }
    }
}

输出