【C言語】テキストファイルを作成する方法を解説

2023-06-262024-07-27

ファイルを開く方法、データを書き込む方法、そしてファイルを閉じる方法を学ぶことで、プログラムから簡単にデータを保存できるようになります。

この記事では、C言語を使ってテキストファイルを作成する方法について詳しく解説します。

また、エラー処理の重要性や実際のコード例も紹介しますので、初心者の方でも安心して理解できる内容になっています。

目次から探す

テキストファイルの作成手順

C言語では、テキストファイルを作成するために、ファイルを開き、データを書き込み、最後にファイルを閉じるという一連の手順を踏む必要があります。

ここでは、その具体的な方法について詳しく解説します。

ファイルを開く

ファイルを操作するためには、まずファイルを開く必要があります。

C言語では、fopen関数を使用してファイルを開きます。

fopen関数の使い方

fopen関数は、次のように使用します。

FILE *fopen(const char *filename, const char *mode);

filename: 開くファイルの名前(パスを含む場合もあります)
mode: ファイルを開くモード(読み込み、書き込みなど)

例えば、output.txtというファイルを作成して書き込みモードで開く場合、次のように記述します。

FILE *file = fopen("output.txt", "w");

このコードでは、output.txtというファイルが存在しない場合は新たに作成され、存在する場合はその内容が消去されます。

モード指定の重要性

ファイルを開く際のモード指定は非常に重要です。

主なモードは以下の通りです。

r: 読み込み専用
w: 書き込み専用(ファイルが存在する場合は内容を消去)
a: 追記モード(ファイルの末尾にデータを追加)
r+: 読み書き両用(ファイルが存在しない場合はエラー)

適切なモードを選択することで、ファイルの操作が正しく行えます。

データの書き込み

ファイルを開いたら、次はデータを書き込みます。

C言語では、fprintf関数やfputs関数を使用してデータをファイルに書き込むことができます。

fprintf関数の使用

fprintf関数は、フォーマット指定子を使ってデータを書き込むことができる関数です。

使用方法は以下の通りです。

int fprintf(FILE *stream, const char *format, ...);

例えば、整数や文字列をファイルに書き込む場合、次のように記述します。

int number = 42;
fprintf(file, "The answer is: %d\n", number);

このコードでは、output.txtに The answer is: 42 という行が書き込まれます。

fputs関数の使用

fputs関数は、文字列をそのままファイルに書き込むための関数です。

使用方法は以下の通りです。

int fputs(const char *str, FILE *stream);

例えば、次のように記述します。

fputs("Hello, World!\n", file);

このコードでは、output.txtに Hello, World! という行が書き込まれます。

ファイルを閉じる

データの書き込みが完了したら、ファイルを閉じる必要があります。

これにはfclose関数を使用します。

fclose関数の役割

fclose関数は、開いているファイルを閉じるための関数です。

使用方法は以下の通りです。

int fclose(FILE *stream);

ファイルを閉じる際は、次のように記述します。

fclose(file);

ファイルを閉じることで、リソースが解放され、他のプログラムやプロセスがそのファイルにアクセスできるようになります。

ファイルを閉じることは、プログラムの健全性を保つために非常に重要です。

以上が、C言語でテキストファイルを作成するための基本的な手順です。

これらの関数を使いこなすことで、さまざまなファイル操作が可能になります。

エラーハンドリング

プログラムを作成する際には、エラー処理が非常に重要です。

特にファイル操作においては、予期しないエラーが発生することがあります。

ここでは、C言語におけるファイルオープン、書き込み、クローズ時のエラー処理について解説します。

ファイルオープン時のエラー処理

ファイルを開く際には、fopen関数を使用しますが、ファイルが正常に開けなかった場合には、NULLが返されます。

このため、ファイルオープン後には必ずエラーチェックを行う必要があります。

以下は、ファイルオープン時のエラー処理の例です。

#include <stdio.h>
int main() {
    FILE *file;
    file = fopen("example.txt", "w"); // 書き込みモードでファイルをオープン
    // ファイルオープンのエラーチェック
    if (file == NULL) {
        perror("ファイルを開けませんでした"); // エラーメッセージを表示
        return 1; // エラーコードを返す
    }
    // ファイル操作...
    fclose(file); // ファイルを閉じる
    return 0;
}

このコードでは、fopenがNULLを返した場合にperror関数を使ってエラーメッセージを表示しています。

これにより、何が問題だったのかをユーザーに伝えることができます。

書き込み時のエラー処理

ファイルにデータを書き込む際にも、エラーが発生する可能性があります。

fprintfやfputsなどの関数を使用してデータを書き込む場合、書き込みが成功したかどうかを確認することが重要です。

以下は、書き込み時のエラー処理の例です。

#include <stdio.h>
int main() {
    FILE *file;
    file = fopen("example.txt", "w");
    if (file == NULL) {
        perror("ファイルを開けませんでした");
        return 1;
    }
    // データを書き込む
    if (fprintf(file, "Hello, World!\n") < 0) {
        perror("書き込みエラーが発生しました"); // エラーメッセージを表示
        fclose(file); // ファイルを閉じる
        return 1;
    }
    fclose(file);
    return 0;
}

この例では、fprintfの戻り値をチェックし、書き込みが失敗した場合にはエラーメッセージを表示しています。

これにより、ユーザーは書き込みエラーの原因を把握できます。

ファイルクローズ時のエラー処理

ファイルを閉じる際にも、fclose関数を使用しますが、正常にファイルが閉じられたかどうかを確認することが推奨されます。

fcloseは、成功した場合には0を返し、エラーが発生した場合にはEOFを返します。

以下は、ファイルクローズ時のエラー処理の例です。

#include <stdio.h>
int main() {
    FILE *file;
    file = fopen("example.txt", "w");
    if (file == NULL) {
        perror("ファイルを開けませんでした");
        return 1;
    }
    fprintf(file, "Hello, World!\n");
    // ファイルを閉じる
    if (fclose(file) != 0) {
        perror("ファイルを閉じる際にエラーが発生しました"); // エラーメッセージを表示
        return 1;
    }
    return 0;
}

このコードでは、fcloseの戻り値をチェックし、エラーが発生した場合にはエラーメッセージを表示しています。

これにより、ファイルが正常に閉じられなかった場合の原因を特定する手助けになります。

エラーハンドリングを適切に行うことで、プログラムの信頼性を高め、ユーザーにとって使いやすいアプリケーションを作成することができます。

実際のコード例

簡単なテキストファイル作成プログラム

まずは、最も基本的なテキストファイルを作成するプログラムを見てみましょう。

このプログラムでは、example.txtという名前のファイルを作成し、Hello, World!というメッセージを書き込みます。

#include <stdio.h>
int main() {
    // ファイルを作成するためにfopenを使用
    FILE *file = fopen("example.txt", "w");
    
    // ファイルが正常にオープンできたか確認
    if (file == NULL) {
        printf("ファイルを開けませんでした。\n");
        return 1; // エラーコードを返す
    }
    // データを書き込む
    fprintf(file, "Hello, World!\n");
    // ファイルを閉じる
    fclose(file);
    
    printf("ファイルが作成されました。\n");
    return 0;
}

このプログラムを実行すると、カレントディレクトリにexample.txtというファイルが作成され、その中にHello, World!というテキストが書き込まれます。

複数行のデータを書き込むプログラム

次に、複数行のデータをファイルに書き込むプログラムを見てみましょう。

このプログラムでは、いくつかのフレーズをphrases.txtというファイルに書き込みます。

#include <stdio.h>
int main() {
    FILE *file = fopen("phrases.txt", "w");
    
    if (file == NULL) {
        printf("ファイルを開けませんでした。\n");
        return 1;
    }
    // 複数行のデータを書き込む
    fprintf(file, "C言語は面白いです。\n");
    fprintf(file, "プログラミングは楽しいです。\n");
    fprintf(file, "ファイル操作を学びましょう。\n");
    fclose(file);
    
    printf("複数行のデータがファイルに書き込まれました。\n");
    return 0;
}

このプログラムを実行すると、phrases.txtというファイルが作成され、3つのフレーズがそれぞれ新しい行に書き込まれます。

ユーザー入力をファイルに保存するプログラム

最後に、ユーザーからの入力を受け取り、それをファイルに保存するプログラムを見てみましょう。

このプログラムでは、ユーザーに名前を入力してもらい、その名前をusername.txtというファイルに書き込みます。

#include <stdio.h>
int main() {
    char name[100]; // ユーザーの名前を格納するための配列
    FILE *file = fopen("username.txt", "w");
    
    if (file == NULL) {
        printf("ファイルを開けませんでした。\n");
        return 1;
    }
    // ユーザーから名前を入力してもらう
    printf("あなたの名前を入力してください: ");
    fgets(name, sizeof(name), stdin); // 標準入力から名前を取得
    // 入力された名前をファイルに書き込む
    fprintf(file, "名前: %s", name);
    fclose(file);
    
    printf("名前がファイルに保存されました。\n");
    return 0;
}

このプログラムを実行すると、ユーザーに名前の入力を促し、その名前がusername.txtというファイルに保存されます。

fgets関数を使用することで、スペースを含む名前も正しく取得できます。