rename

ファイルの名前を変更します。ファイルは old_filename が指す文字列で識別されます。新しいファイル名は new_filename が指す文字列で識別されます。

new_filename が存在する場合、その動作は実装定義である。

パラメータ

戻り値

​ 0 ​ 成功時は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

参考文献

関連項目