C言語でのファイル書き込み手順：テキスト・バイナリ別の実装方法とエラー処理のポイントを解説

2026年5月12日

標準ライブラリ・入出力

C言語におけるファイル操作は、プログラムが生成したデータを永続化するために不可欠な技術です。

標準ライブラリであるstdio.hで提供される関数群を使いこなすことで、数値や文字列をテキスト形式で保存したり、構造体をバイナリ形式で効率的に書き出したりすることが可能になります。

しかし、ファイル書き込みには、OSごとの改行コードの違いやバッファリングの仕組み、そしてファイルオープンの失敗といった、考慮すべき重要なポイントが数多く存在します。

本記事では、初学者から実務レベルを目指すプログラマーまでを対象に、C言語でのファイル書き込み手順を基礎から応用まで詳しく解説します。

テキストモードとバイナリモードの具体的な使い分けから、予期せぬエラーを防ぐための堅牢な実装方法まで、現場で役立つ知識を整理していきましょう。

目次 [ close ]

C言語におけるファイル書き込みの基本手順

C言語でファイルにデータを書き込む際、基本となるのは「ファイルを開く」「データを書き込む」「ファイルを閉じる」という3つのステップです。

これらの操作はすべて、ファイル構造体を指す「ファイルポインタ（FILE *）」を介して行われます。

fopen関数によるファイルのオープン

ファイル操作の第一歩は、fopen関数を使用して特定のファイルへのアクセス権を得ることです。

この関数には、操作対象となる「ファイル名」と、どのような目的で開くかを示す「オープンモード」の2つの引数を渡します。

書き込みを行う際に主に使用されるモードは、新規作成・上書きを意味する「”w”」と、追記を意味する「”a”」です。

もしファイルが正常に開けなかった場合、fopen関数はNULLを返すため、必ず戻り値をチェックする習慣を身につける必要があります。

fclose関数による後処理の重要性

書き込みが完了した後は、速やかにfclose関数を呼び出してファイルを閉じなければなりません。

ファイルを閉じることで、メモリ上に一時的に保持されていたデータ（バッファ）が物理的なディスクへ確実に書き込まれます。

また、オープンしたまま放置すると、システムが同時に開けるファイル数の制限に達し、他のプログラムの動作に悪影響を及ぼす可能性があります。

リソースリークを防ぐためにも、「開いたら必ず閉じる」という原則を徹底しましょう。

テキストモードでのファイル書き込み

テキストモードは、人間がメモ帳などのテキストエディタで直接中身を確認できる形式で保存する方法です。

主にログの出力や設定ファイルの保存、CSVデータの生成などに活用されます。

fprintf関数による書式付き書き込み

fprintf関数は、標準出力で使用するprintf関数と同じ感覚で使用できる非常に便利な関数です。

第1引数にファイルポインタを指定することで、整数や浮動小数点数、文字列を指定した形式で書き込むことができます。

C言語

#include <stdio.h>

int main(void) {
    FILE *fp;
    char *filename = "sample_text.txt";
    int age = 25;
    double height = 175.5;

    // ファイルを書き込みモードで開く
    fp = fopen(filename, "w");
    if (fp == NULL) {
        perror("ファイルオープンに失敗しました");
        return 1;
    }

    // 書式を指定して書き込み
    fprintf(fp, "プロフィール情報\n");
    fprintf(fp, "年齢: %d 歳\n", age);
    fprintf(fp, "身長: %.1f cm\n", height);

    // ファイルを閉じる
    fclose(fp);

    printf("%s に書き込みが完了しました。\n", filename);
    return 0;
}

実行結果

sample_text.txt に書き込みが完了しました。
(ファイル内容)
プロフィール情報
年齢: 25 歳
身長: 175.5 cm

fputs関数とfputc関数の使い分け

単純な文字列のみを書き込む場合は、fputs関数を使用すると処理が軽量になります。

一方で、1文字ずつ制御しながら書き込みたい場合にはfputc関数が適しています。

fprintf関数は多機能ですが、書式解析のオーバーヘッドがあるため、大量の単純な文字列を出力する際はfputsの方が効率的な場合もあります。

用途に合わせて、これらの関数を適切に選択することがプログラムのパフォーマンス向上につながります。

バイナリモードでのファイル書き込み

バイナリモードは、データをメモリ上のビットパターンのまま直接ファイルに記録する方式です。

テキスト変換を行わないため、画像データや音声データ、または複雑な構造体データをそのまま保存するのに最適です。

fwrite関数によるデータの書き出し

バイナリ書き込みには、主にfwrite関数が使用されます。

この関数は、「書き込むデータのポインタ」「1要素のサイズ」「要素の数」「ファイルポインタ」という4つの引数を取ります。

構造体などのまとまったデータを一括で書き出せるため、読み込み時の高速化も期待できるのがメリットです。

C言語

#include <stdio.h>

typedef struct {
    int id;
    char name[20];
    double score;
} Student;

int main(void) {
    FILE *fp;
    Student s = {101, "Taro Tanaka", 88.5};

    // バイナリ書き込みモードで開く
    fp = fopen("data.bin", "wb");
    if (fp == NULL) {
        return 1;
    }

    // 構造体を丸ごと書き込み
    size_t written = fwrite(&s, sizeof(Student), 1, fp);

    if (written != 1) {
        printf("書き込みエラーが発生しました。\n");
    }

    fclose(fp);
    return 0;
}

テキストモードとバイナリモードの決定的な違い

最も大きな違いは、改行コードの変換処理の有無にあります。

Windows環境において、テキストモードではプログラム上の\nがファイル書き込み時に\r\n（CR+LF）へと自動変換されます。

しかし、バイナリモード（”wb”など）では、このような変換は一切行われず、指定したバイトデータがそのまま書き込まれます。

画像や実行ファイルなどを扱う際にテキストモードで開いてしまうと、この変換によってデータが破損してしまうため、注意が必要です。

エラー処理のポイントと実装のベストプラクティス

ファイル操作は、ディスク容量の不足や権限の欠如、外部メディアの取り外しなど、プログラムの外部要因によって失敗する可能性が常にあります。

堅牢なアプリケーションを作成するためには、エラーチェックを省略しないことが極めて重要です。

戻り値による厳格なチェック

前述のfopenだけでなく、fprintfやfwrite、さらにはfcloseにも戻り値が存在します。

fprintfは書き込んだ文字数を返し、失敗すると負の値を返します。

fwriteは書き込みに成功した要素の数を返すため、期待した数と一致するかを確認することで、書き込み失敗を検知できます。

「たぶん大丈夫だろう」という慢心を捨て、すべてのステップで戻り値を検証するコードを記述しましょう。

errnoとperror関数の活用

標準ライブラリの関数が失敗したとき、システム変数errnoにはエラーの原因を示す番号が格納されます。

perror関数を使用すると、そのエラー番号に対応するメッセージを標準エラー出力に分かりやすく表示できます。

デバッグ時やユーザーへの通知において、なぜファイル操作が失敗したのか（ファイルが見つからないのか、権限がないのか等）を特定する強力な手がかりになります。

ファイル書き込みのパフォーマンスとバッファリング

C言語の標準入出力（stdio）は、効率化のためにバッファリングという仕組みを採用しています。

これは、データを1文字ずつ即座にディスクに書き込むのではなく、一定量たまるまでメモリ上のバッファに保持しておく機能です。

fflush関数の役割

プログラムがクラッシュした際、バッファに残っていたデータが消失し、ファイルが不完全な状態で残ることがあります。

重要なデータを書き込んだ直後にfflush関数を呼び出すことで、バッファ内の内容を強制的にディスクへ同期させることができます。

ただし、頻繁なfflushの呼び出しはディスクI/Oを増大させ、パフォーマンスを大幅に低下させるため、使用箇所は慎重に検討すべきです。

setvbuf関数によるバッファサイズの調整

デフォルトのバッファサイズが最適でない場合、setvbuf関数を使用して独自のバッファサイズを設定することが可能です。

大量のデータを高速に出力する必要がある科学技術計算やログ収集システムなどでは、大きなバッファを確保することでスループットを向上させることができます。

逆に、リアルタイム性が求められるシステムでは、バッファリングを無効化（_IONBF）する選択肢も検討されます。

安全性に配慮した書き込み処理

現代のプログラミングにおいては、機能の実装だけでなくセキュリティやデータ整合性への配慮も欠かせません。

既存ファイルの誤消去を防ぐ

「”w”」モードでファイルを開くと、既存の内容はすべて消去され、新しいファイルとして上書きされます。

誤って重要なデータを消去しないよう、ファイルが存在するか事前にチェックしたり、バックアップを作成したりする処理を組み込むのが一般的です。

また、ファイルのアクセス権限（パーミッション）を適切に設定し、悪意のあるユーザーや他のプロセスからデータを守る意識も大切です。

排他制御の検討

複数のプログラムが同時に同じファイルに書き込みを行うと、データの競合が発生し、ファイルの中身が破壊される恐れがあります。

標準のC言語ライブラリ単体では完全なファイルロック機能は提供されていませんが、OS固有のAPI（WindowsのLockFileやLinuxのfcntlなど）を組み合わせて排他制御を行う必要があります。

マルチプロセス・マルチスレッド環境でのファイル書き込みでは、この「排他制御」が安定稼働の鍵を握ります。

実践的な書き込み処理の比較表

これまでに解説した主な書き込み用関数の特徴を、以下の表にまとめました。

関数名	主な用途	主な特徴
fprintf	テキスト（書式付き）	printfと同じ感覚で使えて汎用性が高い
fputs	テキスト（文字列）	文字列のみを高速に書き出すのに適している
fputc	テキスト/バイナリ（1文字）	文字単位での細かい制御が可能
fwrite	バイナリ（ブロック）	構造体や配列を丸ごと高速に書き出せる