ファイル

[C言語] ファイルの名前を変更する方法を解説

C言語でファイルの名前を変更するには、標準ライブラリの関数renameを使用します。

この関数は、rename(const char *old_filename, const char *new_filename)という形式で、最初の引数に変更前のファイル名、2番目の引数に変更後のファイル名を指定します。

成功すると0を返し、失敗すると-1を返します。

失敗した場合、errnoを確認することでエラーの詳細を知ることができます。

この関数は、ファイルが存在しない場合や、アクセス権限がない場合に失敗します。

目次から探す

rename関数の使い方
実際のコード例
応用例
まとめ

rename関数の使い方

C言語でファイルの名前を変更する際に使用するのがrename関数です。

この関数は、標準ライブラリに含まれており、簡単にファイル名を変更することができます。

以下では、rename関数のシンタックス、引数、戻り値とエラーハンドリングについて詳しく解説します。

rename関数のシンタックス

rename関数の基本的なシンタックスは以下の通りです。

#include <stdio.h>
int rename(const char *old_filename, const char *new_filename);

#include <stdio.h>: rename関数`を使用するために必要なヘッダファイルです。
int rename: 関数の戻り値は整数型で、成功時には0を返し、失敗時には0以外の値を返します。

rename関数の引数

rename関数は2つの引数を取ります。

これらの引数は、変更前と変更後のファイル名を指定します。

引数名	説明
`old_filename`	変更したいファイルの現在の名前
`new_filename`	新しいファイル名

old_filename: 既存のファイルの名前を指定します。

このファイルが存在しない場合、関数は失敗します。

new_filename: 新しいファイル名を指定します。

この名前にファイルが変更されます。

rename関数の戻り値とエラーハンドリング

rename関数の戻り値は、操作の成功または失敗を示します。

エラーハンドリングを行うことで、ファイル名の変更が成功したかどうかを確認できます。

戻り値:
0: ファイル名の変更が成功した場合。
0以外: ファイル名の変更が失敗した場合。
エラーハンドリング:
errnoを使用して、失敗の原因を特定することができます。

errnoは、エラーが発生した際に設定されるグローバル変数です。

例：if (rename("old.txt", "new.txt") != 0) { perror("ファイル名の変更に失敗しました"); }

このように、rename関数を使用することで、C言語で簡単にファイル名を変更することができます。

エラーハンドリングを適切に行うことで、プログラムの信頼性を高めることができます。

実際のコード例

ここでは、rename関数を使用した具体的なコード例を紹介します。

基本的なファイル名変更の方法から、エラーチェックを含む例、さらにユーザー入力を利用したファイル名変更の例までを解説します。

基本的なファイル名変更の例

以下は、rename関数を使ってファイル名を変更する基本的な例です。

#include <stdio.h>
int main() {
    // "oldfile.txt"を"newfile.txt"に変更
    if (rename("oldfile.txt", "newfile.txt") == 0) {
        printf("ファイル名の変更に成功しました。\n");
    } else {
        printf("ファイル名の変更に失敗しました。\n");
    }
    return 0;
}

このコードは、oldfile.txtというファイルをnewfile.txtに名前を変更します。

変更が成功した場合は成功メッセージを表示し、失敗した場合は失敗メッセージを表示します。

エラーチェックを含む例

次に、エラーチェックを含む例を示します。

errnoを使用して、エラーの詳細を表示します。

#include <stdio.h>
#include <errno.h>
int main() {
    // "oldfile.txt"を"newfile.txt"に変更
    if (rename("oldfile.txt", "newfile.txt") != 0) {
        perror("ファイル名の変更に失敗しました");
    } else {
        printf("ファイル名の変更に成功しました。\n");
    }
    return 0;
}

このコードでは、rename関数が失敗した場合にperrorを使用してエラーメッセージを表示します。

これにより、失敗の原因を特定することができます。

ユーザー入力を利用したファイル名変更

最後に、ユーザーからの入力を利用してファイル名を変更する例を示します。

#include <stdio.h>
int main() {
    char old_filename[100];
    char new_filename[100];
    // ユーザーに現在のファイル名を入力させる
    printf("現在のファイル名を入力してください: ");
    scanf("%99s", old_filename);
    // ユーザーに新しいファイル名を入力させる
    printf("新しいファイル名を入力してください: ");
    scanf("%99s", new_filename);
    // ファイル名を変更
    if (rename(old_filename, new_filename) == 0) {
        printf("ファイル名の変更に成功しました。\n");
    } else {
        perror("ファイル名の変更に失敗しました");
    }
    return 0;
}

このコードは、ユーザーに現在のファイル名と新しいファイル名を入力させ、その入力に基づいてファイル名を変更します。

scanfを使用してユーザー入力を取得し、rename関数でファイル名を変更します。

エラーチェックも含まれており、失敗した場合にはエラーメッセージを表示します。

応用例

rename関数を活用することで、さまざまな応用が可能です。

ここでは、ファイル名の一括変更、拡張子の変更、ファイル名のバージョン管理といった応用例を紹介します。

ファイル名の一括変更

複数のファイル名を一括で変更する場合、ループを使用してrename関数を繰り返し呼び出すことができます。

以下は、特定のディレクトリ内のファイル名を一括で変更する例です。

#include <stdio.h>
#include <string.h>
int main() {
    char base_name[] = "file";
    char new_base_name[] = "document";
    char old_filename[100];
    char new_filename[100];
    for (int i = 1; i <= 5; i++) {
        sprintf(old_filename, "%s%d.txt", base_name, i);
        sprintf(new_filename, "%s%d.txt", new_base_name, i);
        if (rename(old_filename, new_filename) == 0) {
            printf("%s を %s に変更しました。\n", old_filename, new_filename);
        } else {
            perror("ファイル名の変更に失敗しました");
        }
    }
    return 0;
}

このコードは、file1.txtからfile5.txtまでのファイル名を、それぞれdocument1.txtからdocument5.txtに変更します。

拡張子の変更

ファイルの拡張子を変更する場合も、rename関数を使用できます。

以下は、.txtファイルを.mdファイルに変更する例です。

#include <stdio.h>
#include <string.h>
int main() {
    char old_filename[] = "example.txt";
    char new_filename[100];
    strcpy(new_filename, old_filename);
    strcpy(strrchr(new_filename, '.'), ".md");
    if (rename(old_filename, new_filename) == 0) {
        printf("%s を %s に変更しました。\n", old_filename, new_filename);
    } else {
        perror("ファイル名の変更に失敗しました");
    }
    return 0;
}

このコードは、example.txtというファイルの拡張子を.mdに変更します。

strrchr関数を使用して、拡張子部分を見つけて置き換えています。

ファイル名のバージョン管理

ファイル名にバージョン番号を付けることで、バージョン管理を行うことができます。

以下は、ファイル名にバージョン番号を追加する例です。

#include <stdio.h>
int main() {
    char base_name[] = "report";
    int version = 1;
    char old_filename[100];
    char new_filename[100];
    sprintf(old_filename, "%s.txt", base_name);
    sprintf(new_filename, "%s_v%d.txt", base_name, version);
    if (rename(old_filename, new_filename) == 0) {
        printf("%s を %s に変更しました。\n", old_filename, new_filename);
    } else {
        perror("ファイル名の変更に失敗しました");
    }
    return 0;
}

このコードは、report.txtというファイルにバージョン番号を追加し、report_v1.txtに変更します。

バージョン番号をインクリメントすることで、複数のバージョンを管理することができます。