rename
From cppreference.com
| ヘッダー <stdio.h> で定義 |
||
| int rename( const char* old_filename, const char* new_filename ); |
||
ファイル名を変更します。ファイルは、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"); // 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 関数
[編集] 関連項目
| ファイルを削除する (関数) | |
| rename の C++ ドキュメント
| |