C语言rename()函数：重命名文件或目录

头文件：#include <stdio.h>

函数rename()用于重命名文件、改变文件路径或更改目录名称，其原型为
    int rename(char * oldname, char * newname);

【参数】oldname为旧文件名，newname为新文件名。

【返回值】修改文件名成功则返回0，否则返回-1。

重命名文件：

• 如果newname指定的文件存在，则会被删除。
• 如果newname与oldname不在一个目录下，则相当于移动文件。

重命名目录：

• 如果oldname和oldname都为目录，则重命名目录。
• 如果newname指定的目录存在且为空目录，则先将newname删除。
• 对于newname和oldname两个目录，调用进程必须有写权限。
• 重命名目录时，newname不能包含oldname作为其路径前缀。例如，不能将/usr更名为/usr/foo/testdir，因为老名字（ /usr/foo）是新名字的路径前缀，因而不能将其删除。

【实例】一个简单的修改文件名的程序。

#include<stdio.h>
#include <fcntl.h>
int main(void)
{
    char oldname[100], newname[100];
    /* prompt for file to rename and new name */
    printf("请告诉我一个文件的完整路径: ");
    gets(oldname);
    printf("您想修改为: ");
    gets(newname);
    /* 更改文件名 */
    if (rename(oldname, newname) == 0)
        printf("已经把文件 %s 修改为 %s.\n", oldname, newname);
    else
        perror("rename");
    return 0;
}

运行结果：

例子首先定义两个数组存储用户指定的文件名， 接着使用函数gets()接收用户输入的文件名，再使用函数rename()修改，如果成功则返回值为0，提示修改成功。

注意：实际开发中尽量避免使用gets()函数，gets()会影响程序的安全性和健壮性，请查看：C语言gets()函数：从流中读取字符串

又如，设计一个在DOS命令行下修改文件的程序。

#include <stdio.h>
void main(int argc, char **argv)
{
    if(argc < 3)
    {
        printf("Usage: %s old_name new_name\n", argv[0]);
        return;
    }
    printf("%s=>%s", argc[1], argv[2]);
    if(rename(argv[1], argv[2]) < 0)
    printf("error!\n");
    else
    printf("ok!\n");
}