≫ ホーム ≫ C言語Tips集 ≫ ファイル ≫ ファイル名を変更する

C言語Tips集 - ファイル名を変更する

C言語でファイルの名前を変更するには stdio.h の rename 関数を使用します．

rename

#include <stdio.h>

int rename (
    const char *old,
    const char *new
);

rename 関数は old が指すファイルを new が指す文字列を名前とするファイルとして識別できるようにする関数です． old と new が同じディレクトリのファイル名を指している場合には，ファイル名の変更が行われます．

rename 関数はファイル名の変更が成功したときには 0 を，ファイル名の変更に失敗したときには 0 以外の値を返します．

rename 関数を呼び出す前に既にファイル名が new であるファイルが存在していたとき，rename 関数の動作は処理系定義となりますので注意が必要です．

C言語サンプルプログラム

以下に rename 関数を使用してファイル名を変更するサンプルプログラムを示します．

/* header files */
#include <stdio.h>
#include <stdlib.h>

/* main */
int main(void) {
    char old[] = "sample01.txt";
    char new[] = "sample02.txt";

    if ( rename(old, new) == 0 ) {
        printf("%sの名前を%sに変更しました．\n", old, new);
    } else {
        fprintf(stderr, "%sのリネームに失敗しました．\n", old);
    }

    return EXIT_SUCCESS;
}

実行例

サンプルプログラムの実行結果は以下のようになります．

(カレントディレクトリにsample01.txtが存在する場合)
sample01.txtの名前をsample02.txtに変更しました．

(カレントディレクトリにsample01.txtが存在しない場合)
sample01.txtのリネームに失敗しました．