在C语言中，rename是一个标准库函数，用于更改文件或目录的名称，也可以将文件从一个路径移动到另一个路径。它定义在stdio.h头文件中，是进行文件管理时非常基础且常用的接口。
rename函数的基本定义
rename函数的原型如下：
#include <stdio.h> int rename(const char *old_filename, const char *new_filename);
其中，old_filename表示原有的文件或目录路径，new_filename表示新的文件或目录路径。函数返回类型为int，若重命名成功则返回0，若失败则返回非0值。
rename函数的具体含义
从语义上看，rename在C语言里的意思就是“重命名”。它不仅仅是改个文件名那么简单，在多数操作系统中，如果新旧路径位于同一文件系统，rename还可以当作移动文件来用。例如把文件从临时目录移到目标目录。
常见使用场景
- 修改上传文件的保存名称
- 将临时文件替换为正式文件
- 整理目录结构时批量移动文件
代码示例
下面是一个简单的C语言程序，演示如何使用rename函数将文件old.txt改名为new.txt：
#include <stdio.h>
int main(void) {
const char *old_name = "old.txt";
const char *new_name = "new.txt";
// 调用rename函数进行重命名
if (rename(old_name, new_name) == 0) {
printf("文件重命名成功n");
} else {
printf("文件重命名失败n");
}
return 0;
}
使用rename的注意事项
权限与存在性
调用rename时，程序需要对旧路径有访问权限，对新路径所在的目录有写权限。如果新路径已经存在，其行为依赖系统：在类Unix系统中，已存在的文件会被自动替换；在部分旧标准中则可能直接失败。
跨设备限制
如果旧路径和新路径处于不同的文件系统（例如从U盘移到硬盘），rename可能会返回失败。此时应先复制文件再删除源文件。
| 情况 | rename行为 |
|---|---|
| 同一目录改名 | 直接修改名称 |
| 同文件系统跨目录 | 相当于移动文件 |
| 不同文件系统 | 通常失败，需手动拷贝 |
错误处理
当rename返回非0时，可以结合errno和perror来定位问题：
#include <stdio.h>
#include <errno.h>
int main(void) {
if (rename("a.txt", "b.txt") != 0) {
perror("rename失败");
printf("错误码: %dn", errno);
}
return 0;
}
总之，C语言里的rename函数就是用来重命名或移动文件的标准接口，理解它的参数、返回值以及系统相关行为，能让你在文件操作开发中少踩很多坑。
renameC_languagefile_operation修改时间：2026-07-26 12:57:23