0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

【C言語入門】第13章 ファイルの読み書き

0
Last updated at Posted at 2026-11-18

この章では、プログラムからファイルに文字を書き込んだり、ファイルの中身を読み込んだりする方法を学びます。変数や配列の値は、プログラムが終わると消えてしまいますが、ファイルに書いておけば、プログラムが終わった後も残ります。最後に、社員の構造体の配列をファイルに書き、読み戻します。

この章で学ぶこと

  • fopen・fprintf・fclose で、ファイルに書く方法
  • ファイルを開くときの指定("w"・"a"・"r")の違い
  • fgets でファイルを1行ずつ読み、行の終わりの改行を取り除く方法
  • ファイルを開けなかったときに NULL を確かめる理由
  • 構造体の配列をファイルに書き、読み戻す方法

13.1 ファイルに書く

ファイルに文字を書き込みます。c-practice の中に file_write.c を作り、次のコードを入力して保存し、▷ で実行します。

file_write.c
#define _CRT_SECURE_NO_WARNINGS
#include <stdio.h>

int main(void)
{
    FILE *fp = fopen("memo.txt", "w");
    fprintf(fp, "雷禅 海皇\n");
    fprintf(fp, "院照 心愛\n");
    fclose(fp);
    printf("memo.txt に書きました\n");
    return 0;
}
実行の結果
memo.txt に書きました

実行すると、c-practice の中に memo.txt ができます。エクスプローラーの欄で memo.txt をクリックして開き、次の2行が書かれていることを確かめてください。

memo.txt
雷禅 海皇
院照 心愛
書いたもの 意味
FILE *fp 開いたファイルを指すポインタの変数。FILE は、stdio.h で決められている、ファイルを扱うための構造体の型。名前の fp は、file pointer の略としてよく使われる
fopen("memo.txt", "w") memo.txt を開く。"w" は書き込み(write)の指定(13.2)。開いたファイルを指すポインタを返す
fprintf(fp, "雷禅 海皇\n") fp が指すファイルに、文字列を書き込む。書き方は、最初に fp を書くこと以外は printf と同じで、%d などの書式も使える
fclose(fp) ファイルを閉じる。開いたファイルは、使い終わったら必ず閉じる

fopen でファイルを開いてポインタ fp を受け取り、fprintf で fp に書き込み、fclose で閉じる
図13-1 ファイルを開いて、書いて、閉じる

【知識メモ】ファイルができる場所

"memo.txt" のように、ファイルの名前だけを書いたときは、プログラムを実行しているフォルダーにファイルができます。この教材では、▷ で実行すると、実行ファイル(file_write.exe)と同じ c-practice の中にできます。

【再確認】1行目の #define

fopen や、13.5 で使う fscanf も、scanf と同じように、書き方によっては「warning C4996」の警告が出ます。第4章 4.5 と同じ #define _CRT_SECURE_NO_WARNINGS を1行目に書いておけば、警告は出ません。この章のプログラムは、すべて1行目にこの行を書きます。

13.2 ファイルを開くときの指定(w・a・r)

fopen の2つ目の引数で、ファイルをどう開くかを指定します。file_write.c の "w" は、書き込みの指定です。

指定 意味
"w" 書き込み(write)。ファイルが無ければ作り、あれば中身を消してから書く
"a" 追記(append)。ファイルの最後に書き足す。ファイルが無ければ作る
"r" 読み込み(read)。ファイルが無いときは、開けずに NULL が返る(13.4)

"a" で開いて、3人目を書き足します。file_append.c を作り、次のコードを入力して保存し、実行します。

file_append.c
#define _CRT_SECURE_NO_WARNINGS
#include <stdio.h>

int main(void)
{
    FILE *fp = fopen("memo.txt", "a");
    fprintf(fp, "林檎 星飛\n");
    fclose(fp);
    printf("memo.txt に書き足しました\n");
    return 0;
}
実行の結果
memo.txt に書き足しました

エディターで開いている memo.txt のタブをクリックすると、3行になっています。

memo.txt
雷禅 海皇
院照 心愛
林檎 星飛

2行が書かれた memo.txt に、"林檎 星飛\n" の1行を書くと、"w" と "a" では、ファイルの中身が次のように変わります。

2行が書かれた memo.txt に 林檎 星飛 を書くと、w で開いたときは前の2行が消えて林檎 星飛の1行だけになり、a で開いたときは前の2行の後ろに林檎 星飛が増えて3行になる
図13-2 "w" と "a" で書いたときの違い

【ご注意】"w" で開くと、前の中身は消える

"w" で開くと、ファイルにすでに書かれていた中身は消えてしまいます。前の中身を残したまま書き足すときは、"a" で開きます。また、file_append.c は、実行するたびに「林檎 星飛」を1行書き足します。13.3 の結果と同じにするには、file_write.c → file_append.c の順に1回ずつ実行した状態にしてください。

13.3 1行ずつ読む

memo.txt の中身を、1行ずつ読み込んで表示します。file_read.c を作り、次のコードを入力して保存し、実行します。

file_read.c
#define _CRT_SECURE_NO_WARNINGS
#include <stdio.h>
#include <string.h>

int main(void)
{
    FILE *fp = fopen("memo.txt", "r");
    char line[64];
    while (fgets(line, sizeof(line), fp) != NULL) {
        size_t len = strlen(line);
        if (line[len - 1] == '\n') {
            line[len - 1] = '\0';
        }
        printf("%sさん\n", line);
    }
    fclose(fp);
    return 0;
}
実行の結果
雷禅 海皇さん
院照 心愛さん
林檎 星飛さん
書いたもの 意味
fopen("memo.txt", "r") memo.txt を、読み込むために開く
fgets(line, sizeof(line), fp) fp が指すファイルから1行を読み、文字の配列 line に入れる。2つ目の引数は配列の大きさ(バイト数)で、それより長い行は、入る所までで区切って読む。行の最後の改行(\n)も line に入る
!= NULL fgets は、読む行が残っていないとき(ファイルの終わりまで読んだとき)に NULL を返す。NULL でないあいだ、繰り返す
size_t len = strlen(line); 読んだ行の長さ(バイト数)を求める(第8章 8.2)。size_t は、strlen が返す、大きさを表す整数の型
line[len - 1] = '\0'; 最後の文字が改行なら、そこに文字列の終わりの印 '\0' を入れて、改行を取り除く

行の終わりの改行を取り除く

fgets で読んだ line には、行の最後の改行も入っています。改行を取り除く行(10行目〜13行目)が無いと、「さん」の前で改行されて、次のように表示されます。

実行の結果(改行を取り除かないとき)
雷禅 海皇
さん
院照 心愛
さん
林檎 星飛
さん

1行目の "雷禅 海皇\n" は、ひらがな・漢字が1文字3バイトなので、12バイトの文字と空白1バイト、改行1バイトの14バイトです(第8章 8.3)。len は 14 になり、line[13] の改行を '\0' に変えると、文字列は "雷禅 海皇" で終わります。

fgets で読んだ line には、雷禅 海皇 の13バイトの後ろに改行と終わりの印が入っている。最後の改行 line[13] を終わりの印に変えると、文字列は 雷禅 海皇 で終わる
図13-3 行の終わりの改行を '\0' に変える

実行の順番

9行目からの読み込みは、次の順に実行されます。

  1. 【開く】7行目で、memo.txt を読み込むために開きます。
  2. 1回目のループ
    • 【1行読む】9行目の fgets が、1行目の "雷禅 海皇\n"(最後に改行が付いている)を line に入れます。NULL ではないので、ブロックに進みます。
    • 【改行を取る】10行目〜13行目で、最後の改行を '\0' に変え、line は "雷禅 海皇" になります。
    • 【表示する】14行目で「雷禅 海皇さん」と表示されます。
  3. 2回目・3回目のループ
    • 同じように、「院照 心愛さん」「林檎 星飛さん」と表示されます。
  4. 4回目(ここで終わり):読む行が残っていないので、fgets が NULL を返し、繰り返しが終わります。16行目でファイルを閉じます。

【知識メモ】ファイルの最後の行に改行が無いとき

11行目で、最後の文字が改行かどうかを確かめてから取り除いているのは、改行の無い行もあるためです。メモ帳などで作ったファイルは、最後の行に改行が付いていないことがあります。また、line の大きさ(64バイト)より長い行は、途中で区切って読まれるので、区切られた前の部分には改行がありません。

13.4 ファイルを開けなかったとき

fopen は、ファイルを開けなかったときに NULL を返します(第10章 10.5)。たとえば、"r" で開こうとしたファイルが無いときです。NULL のまま fgets や fprintf に渡すと、プログラムは途中で止まってしまいます。そこで、fopen の後には、必ず NULL かどうかを確かめます。

無いファイル(member.txt)を開いてみます。file_check.c を作り、次のコードを入力して保存し、実行します。

file_check.c
#define _CRT_SECURE_NO_WARNINGS
#include <stdio.h>

int main(void)
{
    FILE *fp = fopen("member.txt", "r");
    if (fp == NULL) {
        printf("member.txt を開けませんでした\n");
        return 1;
    }
    char line[64];
    while (fgets(line, sizeof(line), fp) != NULL) {
        printf("%s", line);
    }
    fclose(fp);
    return 0;
}
実行の結果
member.txt を開けませんでした

member.txt は無いので、fopen が NULL を返し、7行目の if のブロックに入ります。メッセージを表示して、return 1; で main 関数を終えます。main の return 0; の 0 は「正しく終わった」ことを表すので(第3章 3.4)、うまくいかずに終わるときは、0 以外の値(ここでは 1)を返します。

c-practice の中に member.txt を作り、何行か書いて保存してから実行し直すと、その中身が表示されます。fgets で読んだ行には改行が付いているので、printf("%s", line) のように \n を書かずに表示しています。

【再確認】fopen の後は、必ず NULL を確かめる

13.1〜13.3 のプログラムは、短くするために確かめを省きましたが、fopen の後には、if (fp == NULL) で確かめる文を必ず書きます。13.5 のプログラムでも、この形で確かめます。第12章 12.3 の malloc の後の確かめと同じ考え方です。

13.5 社員をファイルに書いて読む

社員の構造体(第11章 11.2)の配列をファイルに書き、別の配列に読み戻します。1人の社員を1行にして、社員ID・氏名・性別・年齢・部署・住所の間を タブ(\t)で区切ります。氏名に空白が入っているので、空白では区切れないためです。emp_file.c を作り、次のコードを入力して保存し、実行します。

emp_file.c
#define _CRT_SECURE_NO_WARNINGS
#include <stdio.h>

typedef struct {
    int id;
    char name[64];
    char gender[8];
    int age;
    char dept[32];
    char address[32];
} Employee;

int main(void)
{
    Employee list[3] = {
        {1, "雷禅 海皇", "男", 26, "営業部", "大阪府"},
        {2, "院照 心愛", "女", 27, "総務部", "京都府"},
        {3, "林檎 星飛", "男", 24, "開発部", "東京都"}
    };

    // 書く:1人を1行にし、項目の間をタブ(\t)で区切る
    FILE *fp = fopen("employees.txt", "w");
    if (fp == NULL) {
        printf("employees.txt を開けませんでした\n");
        return 1;
    }
    for (int i = 0; i < 3; i++) {
        fprintf(fp, "%d\t%s\t%s\t%d\t%s\t%s\n", list[i].id, list[i].name,
                list[i].gender, list[i].age, list[i].dept, list[i].address);
    }
    fclose(fp);
    printf("employees.txt に書きました\n");

    // 読む:1行ずつ、Employee の配列に読み戻す
    Employee loaded[10];
    int count = 0;
    fp = fopen("employees.txt", "r");
    if (fp == NULL) {
        printf("employees.txt を開けませんでした\n");
        return 1;
    }
    while (count < 10 &&
           fscanf(fp, "%d\t%63[^\t]\t%7[^\t]\t%d\t%31[^\t]\t%31[^\n]",
                  &loaded[count].id, loaded[count].name, loaded[count].gender,
                  &loaded[count].age, loaded[count].dept, loaded[count].address) == 6) {
        count++;
    }
    fclose(fp);

    printf("%d人を読みました\n", count);
    for (int i = 0; i < count; i++) {
        printf("%d %s %s %d歳 %s %s\n", loaded[i].id, loaded[i].name,
               loaded[i].gender, loaded[i].age, loaded[i].dept, loaded[i].address);
    }
    return 0;
}
実行の結果
employees.txt に書きました
3人を読みました
1 雷禅 海皇 男 26歳 営業部 大阪府
2 院照 心愛 女 27歳 総務部 京都府
3 林檎 星飛 男 24歳 開発部 東京都

c-practice の中にできた employees.txt を開くと、次の中身になっています。タブは、空白が広くあいたように見えます。

employees.txt
1	雷禅 海皇	男	26	営業部	大阪府
2	院照 心愛	女	27	総務部	京都府
3	林檎 星飛	男	24	開発部	東京都
書いたもの 意味
\t タブを表す文字。\n と同じように、\ を付けて書く
fprintf(fp, "%d\t%s\t…\n", …) 社員1人のメンバーを、タブで区切って1行に書く。printf と同じ書式が使える
fscanf(fp, "…", …) fp が指すファイルから、書式のとおりに値を読み、後ろの変数に入れる。書き方は、最初に fp を書くこと以外は scanf と同じ。値を入れる int のメンバーには & を付け、文字の配列には付けない
%63[^\t] タブの手前までの文字を、63バイトまで読む。第8章 8.4 の %63[^\n](改行の手前まで)と同じ書き方で、区切りの文字をタブにしたもの
== 6 fscanf は、値を入れられた変数の数を返す。6つのメンバーがすべて読めたときだけ、繰り返しを続ける。ファイルの終わりまで読むと、6 にならないので終わる
count < 10 && 配列 loaded は10人分なので、10人読んだら、それより先は読まない(第7章 7.5)

構造体の6つのメンバーを、タブで区切って1行に書く。読むときは、fscanf でタブの所で区切って、6つのメンバーに入れ直す
図13-4 構造体1つを、タブで区切った1行にする

42行目からの読み込みは、次の順に実行されます。

  1. 【1人目】count は 0 です。count < 10 が真なので、fscanf が1行目を読み、loaded[0] の6つのメンバーに値を入れます。6つ読めたので 6 を返し、ブロックの count++ で count が 1 になります。
  2. 【2人目・3人目】同じように、loaded[1]・loaded[2] に読み、count が 3 になります。
  3. 【終わり】4回目は、読む行が残っていないので、fscanf は 6 を返しません。繰り返しが終わり、count は 3 のままです。

このように書いておくと、プログラムを終わらせた後も、社員の情報が employees.txt に残り、次に実行したときに読み戻せます。第14章 の社員一覧のプログラムは、ファイルには保存しませんが、この節の書き方で保存する機能を足すことができます(第14章 14.6)。

【知識メモ】fscanf の書式の \t

fscanf の書式の中の \t は、ファイルの中のタブ(と空白・改行)を読み飛ばします。最後の %31[^\n] は、改行の手前までを住所として読みます。行の最後の改行は、次の行の %d が読み飛ばすので、取り除く必要はありません。

13.6 うまくいかないときは

症状 考えられる原因と対処
「… を開けませんでした」と表示される 読み込もうとしたファイルがありません。ファイルの名前の打ち間違いと、ファイルが c-practice の中にあるかを確かめてください。memo.txt は 13.1 の file_write.c を、先に実行して作ります。
何も表示されずに、プログラムが終わる fopen が NULL を返したのに、確かめずに fgets などに渡しています。fopen の後に if (fp == NULL) の確かめを書いてください(13.4)。
ファイルの中身が消えてしまった "w" で開くと、前の中身は消えます。書き足すときは "a" で開きます(13.2)。
読んだ行を表示すると、間に空の行が入る、「さん」が次の行に表示される fgets で読んだ行の最後には改行が入っています。改行を取り除くか(13.3)、printf("%s", line) のように \n を書かずに表示します。
memo.txt の「林檎 星飛」が何行もある file_append.c を何回も実行しました。実行するたびに1行書き足されます。file_write.c を実行し直すと、2行の状態に戻ります。
社員を読み戻すと、0人になる・途中までしか読めない fprintf と fscanf の書式で、区切りの \t の数や、%d・%s の並びがそろっていません。employees.txt を開いて、1行の中身を確かめてください。
「warning C4996: 'fopen': This function or variable may be unsafe.」と表示される 1行目の #define _CRT_SECURE_NO_WARNINGS がありません。#include より前に書きます。

そのほかのエラーは、付録A「よくあるエラーと対処法」を見てください。

13.7 まとめと確認問題

まとめ

  • FILE *fp = fopen(ファイル名, 開き方); でファイルを開き、使い終わったら fclose(fp); で閉じる
  • 開き方は、"w"(書き込み。前の中身は消える)・"a"(追記)・"r"(読み込み)
  • fopen は、開けなかったときに NULL を返す。fopen の後は、必ず if (fp == NULL) で確かめる
  • fprintf(fp, …) は、printf と同じ書式でファイルに書く。fscanf(fp, …) は、scanf と同じ書式でファイルから読む
  • fgets(line, sizeof(line), fp) で1行ずつ読む。読む行が無くなると NULL を返す。読んだ行の最後の改行は、'\0' に変えて取り除く
  • 構造体の配列は、1つを1行にして、メンバーをタブで区切って書くと、fscanf で読み戻せる

確認問題

問1 すでに中身のある log.txt に、前の中身を残したまま1行書き足したいときは、fopen の開き方に何を指定しますか。

解答を見る

"a"(追記)です。"w" にすると、前の中身が消えてしまいます。

問2 fopen の後に if (fp == NULL) を書くのはなぜですか。

解答を見る

fopen は、ファイルが無いときなど、ファイルを開けなかったときに NULL を返すためです。NULL のまま fgets や fprintf に渡すと、プログラムが途中で止まってしまいます。

問3 fgets で読んだ line を printf("%s。\n", line); で表示すると、「。」が次の行に表示されました。なぜですか。また、どう直しますか。

解答を見る

fgets で読んだ行の最後に、改行(\n)が入っているためです。strlen で長さを求め、最後の文字が '\n' なら '\0' に変えて、改行を取り除いてから表示します。

問4 memo.txt に、for 文で「1行目」「2行目」「3行目」の3行を書くプログラムの、fopen から fclose までを書いてください(fopen の確かめも書きます)。

解答を見る
例
    FILE *fp = fopen("memo.txt", "w");
    if (fp == NULL) {
        printf("memo.txt を開けませんでした\n");
        return 1;
    }
    for (int i = 1; i <= 3; i++) {
        fprintf(fp, "%d行目\n", i);
    }
    fclose(fp);

fprintf では、printf と同じように %d が使えます。


前へ

第12章 メモリの確保

次へ

第14章 社員一覧のプログラムを作る

目次へ

【C言語入門】目次

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?