rename
来自cppreference.com
| 在标头 <stdio.h> 定义
|
||
| |
||
更改文件的文件名。该文件以 old_filename 所指向的字符串标识。新文件名以 new_filename 所指向的字符串标识。
若 new_filename 存在，则行为是实现定义的。
参数
| old_filename | - | 指向包含标识要重命名的文件的路径的空终止字符串的指针 |
| new_filename | - | 指向包含文件新路径的空终止字符串的指针 |
返回值
成功时为 0 ，失败时为非零值。
注意
POSIX 指定许多关于此函数语义的附加细节。
示例
运行此代码
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
FILE* fp = fopen("from.txt", "w"); // 创建文件 "from.txt"
if (!fp)
{
perror("from.txt");
return EXIT_FAILURE;
}
fputc('a', fp); // 写入到 "from.txt"
fclose(fp);
int rc = rename("from.txt", "to.txt");
if (rc)
{
perror("rename");
return EXIT_FAILURE;
}
fp = fopen("to.txt", "r");
if(!fp)
{
perror("to.txt");
return EXIT_FAILURE;
}
printf("%c\n", fgetc(fp)); // 从 "to.txt" 读取
fclose(fp);
return EXIT_SUCCESS;
}
可能的输出：
a
引用
- C23 标准（ISO/IEC 9899:2024）：
- 7.21.4.2 The rename function （第 TBD 页）
- C17 标准（ISO/IEC 9899:2018）：
- 7.21.4.2 The rename function （第 TBD 页）
- C11 标准（ISO/IEC 9899:2011）：
- 7.21.4.2 The rename function （第 302-303 页）
- C99 标准（ISO/IEC 9899:1999）：
- 7.19.4.2 The rename function （第 268-269 页）
- C89/C90 标准（ISO/IEC 9899:1990）：
- 4.9.4.2 The rename function
参阅
| 删除文件 (函数) | |
rename 的 C++ 文档
| |