この章では、プログラムからファイルに文字を書き込んだり、ファイルの中身を読み込んだりする方法を学びます。変数や配列の値は、プログラムが終わると消えてしまいますが、ファイルに書いておけば、プログラムが終わった後も残ります。最後に、社員の構造体の配列をファイルに書き、読み戻します。
この章で学ぶこと
-
fopen・fprintf・fcloseで、ファイルに書く方法 - ファイルを開くときの指定(
"w"・"a"・"r")の違い -
fgetsでファイルを1行ずつ読み、行の終わりの改行を取り除く方法 - ファイルを開けなかったときに
NULLを確かめる理由 - 構造体の配列をファイルに書き、読み戻す方法
13.1 ファイルに書く
ファイルに文字を書き込みます。c-practice の中に 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行が書かれていることを確かめてください。
雷禅 海皇
院照 心愛
| 書いたもの | 意味 |
|---|---|
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) |
ファイルを閉じる。開いたファイルは、使い終わったら必ず閉じる |
【知識メモ】ファイルができる場所
"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 を作り、次のコードを入力して保存し、実行します。
#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行になっています。
雷禅 海皇
院照 心愛
林檎 星飛
2行が書かれた memo.txt に、"林檎 星飛\n" の1行を書くと、"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 を作り、次のコードを入力して保存し、実行します。
#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' に変えると、文字列は "雷禅 海皇" で終わります。
実行の順番
9行目からの読み込みは、次の順に実行されます。
- 【開く】7行目で、
memo.txtを読み込むために開きます。 - 1回目のループ
- 【1行読む】9行目の
fgetsが、1行目の"雷禅 海皇\n"(最後に改行が付いている)をlineに入れます。NULLではないので、ブロックに進みます。 - 【改行を取る】10行目〜13行目で、最後の改行を
'\0'に変え、lineは"雷禅 海皇"になります。 - 【表示する】14行目で「雷禅 海皇さん」と表示されます。
- 【1行読む】9行目の
- 2回目・3回目のループ
- 同じように、「院照 心愛さん」「林檎 星飛さん」と表示されます。
- 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 を作り、次のコードを入力して保存し、実行します。
#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 を作り、次のコードを入力して保存し、実行します。
#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 を開くと、次の中身になっています。タブは、空白が広くあいたように見えます。
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) |
42行目からの読み込みは、次の順に実行されます。
- 【1人目】
countは 0 です。count < 10が真なので、fscanfが1行目を読み、loaded[0]の6つのメンバーに値を入れます。6つ読めたので 6 を返し、ブロックのcount++でcountが 1 になります。 - 【2人目・3人目】同じように、
loaded[1]・loaded[2]に読み、countが 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 が使えます。


![fgets で読んだ line には、雷禅 海皇 の13バイトの後ろに改行と終わりの印が入っている。最後の改行 line[13] を終わりの印に変えると、文字列は 雷禅 海皇 で終わる](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F85823%2Fadc87c5f-515a-41a7-ba90-69895a1cdbb6.png?ixlib=rb-4.1.1&auto=format&gif-q=60&q=75&s=1d7b2e8b841b10ca73431e9e8e0a264d)
