rename
来自 cppreference.cn
定义于头文件 <stdio.h> |
||
int rename( const char* old_filename, const char* new_filename ); |
||
更改文件的文件名。文件由 old_filename 指向的字符字符串标识。新文件名由 new_filename 指向的字符字符串标识。
如果 new_filename 存在,则行为是实现定义的。
内容 |
[编辑] 参数
old_filename | - | 指向空终止字符串的指针,该字符串包含标识要重命名的文件的路径 |
new_filename | - | 指向空终止字符串的指针,该字符串包含文件的新路径 |
[编辑] 返回值
0 成功时返回 0,错误时返回非零值。
[编辑] 注意
POSIX 详细说明了此函数的语义的许多其他细节。
[编辑] 示例
运行此代码
#include <stdio.h> #include <stdlib.h> int main(void) { FILE* fp = fopen("from.txt", "w"); // create file "from.txt" if (!fp) { perror("from.txt"); return EXIT_FAILURE; } fputc('a', fp); // write to "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)); // read from "to.txt" fclose(fp); return EXIT_SUCCESS; }
可能的输出
a
[编辑] 参考文献
- C23 标准 (ISO/IEC 9899:2024)
- 7.21.4.2 rename 函数 (p: TBD)
- C17 标准 (ISO/IEC 9899:2018)
- 7.21.4.2 rename 函数 (p: TBD)
- C11 标准 (ISO/IEC 9899:2011)
- 7.21.4.2 rename 函数 (p: 302-303)
- C99 标准 (ISO/IEC 9899:1999)
- 7.19.4.2 rename 函数 (p: 268-269)
- C89/C90 标准 (ISO/IEC 9899:1990)
- 4.9.4.2 rename 函数
[编辑] 参见
删除文件 (函数) | |
C++ 文档 关于 rename
|