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; 
}

#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;}

运行结果：
请告诉我一个文件的完整路径：test.ncb
您想修改为：test111.ncb
已经把文件test. ncb修改为test111. ncb

例子首先定义两个数组存储用户指定的文件名， 接着使用函数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"); 
}