C++でのファイル書き込み方法を解説：fstreamからC++23の最新手法まで

2026年5月15日

入出力・ファイル操作

C++プログラミングにおいて、外部ファイルへのデータ出力は基本的な操作でありながら、言語の進化とともにその手法は多様化しています。

古くから利用されている標準ライブラリのfstreamから、最新のC++23で導入された効率的な出力手法まで、状況に応じた最適な選択肢を知ることが重要です。

この記事では、C++におけるファイル書き込みの基礎から応用、そして最新規格であるC++23での変更点を含めて詳しく解説します。

目次 [ close ]

C++におけるファイル書き込みの基本：std::ofstream

C++でファイルにテキストを書き込む最も一般的な方法は、<fstream>ヘッダーに含まれるstd::ofstreamクラスを使用することです。

std::ofstreamは「output file stream」の略であり、ファイルへの出力操作を抽象化したクラスです。

基本的な使い方は非常にシンプルで、ファイル名を指定してオブジェクトを作成し、挿入演算子（<<）を使用してデータを流し込みます。

基本的なファイル出力のコード例

まずは、テキストファイルを作成し、文字列を書き込む基本的なプログラムを見てみましょう。

C++

#include <iostream>
#include <fstream>
#include <string>

int main() {
    // 書き込み用のファイルストリームを作成
    std::ofstream ofs("example.txt");

    // ファイルが正常に開けたか確認
    if (!ofs) {
        std::cerr << "ファイルのオープンに失敗しました。" << std::endl;
        return 1;
    }

    // データの書き込み
    ofs << "Hello, C++ World!" << std::endl;
    ofs << "ファイル書き込みの基本テストです。" << std::endl;

    // ファイルを閉じる（デストラクタで自動的に閉じられますが明示的にも可能）
    ofs.close();

    std::cout << "書き込みが完了しました。" << std::endl;
    return 0;
}

実行結果

書き込みが完了しました。

このコードでは、example.txtというファイルが作成され、指定した文字列が書き込まれます。

std::ofstreamのオブジェクトはスコープを抜ける際にデストラクタが呼ばれ、自動的にファイルがクローズされるため、リソースリークの心配が少ないのが特徴です。

ファイルオープンのモード設定

ファイルを書き込む際、既存のファイルを上書きするのか、あるいは末尾に追記するのかといった動作を指定する必要があります。

これらはstd::ios_base::openmodeというフラグを組み合わせて指定します。

モードフラグ	説明
`std::ios::out`	書き込みモードで開く（デフォルト）。
`std::ios::app`	追記モード。常にファイルの末尾に書き込む。
`std::ios::trunc`	既存のファイルがある場合、中身を削除して新しく作成する。
`std::ios::ate`	オープン時にファイルポインタを末尾に移動する。
`std::ios::binary`	バイナリモードで開く（改行コードの変換を行わない）。

例えば、既存のログファイルにデータを追記したい場合は、以下のように記述します。

C++

std::ofstream ofs("log.txt", std::ios::app);

このように、用途に応じて適切なオープンモードを選択することが、予期せぬデータ消失を防ぐ鍵となります。

バイナリファイルの書き込み

テキストデータではなく、数値データや構造体をそのまま保存したい場合は、バイナリモードを使用します。

バイナリ形式はテキスト形式に比べてデータサイズを小さく抑えられ、読み書きの速度も向上するメリットがあります。

バイナリ書き込みにはwriteメンバ関数を使用します。

C++

#include <iostream>
#include <fstream>

int main() {
    int data[] = {10, 20, 30, 40, 50};
    
    // バイナリモードでオープン
    std::ofstream ofs("data.bin", std::ios::binary);

    if (!ofs) return 1;

    // 配列全体をバイナリとして書き込み
    ofs.write(reinterpret_cast<const char*>(data), sizeof(data));

    ofs.close();
    std::cout << "バイナリデータの保存に成功しました。" << std::endl;
    return 0;
}

バイナリ書き込みの際は、型安全性を確保するためにreinterpret_cast<const char*>を使用する必要があります。

また、ポインタを含む構造体をそのまま書き込んでも、再読み込み時にそのポインタが有効ではないため、シリアライズの設計には注意が必要です。

ファイル書き込みのパフォーマンス最適化

大量のデータをファイルに書き込む場合、パフォーマンスが問題になることがあります。

C++のストリーム操作において、最もパフォーマンスに影響を与える要素の一つが「バッファのフラッシュ」です。

std::endl と \n の違い

多くの初心者は改行の際にstd::endlを使用しますが、これは単なる改行文字（\n）の挿入ではありません。

std::endlは、改行を挿入した直後にストリームのバッファを強制的に物理ファイルへ書き出す（フラッシュする）という動作を行います。

頻繁にフラッシュが発生すると、OSのI/O回数が増大し、実行速度が著しく低下します。

高速な書き込みが必要な場合は、std::endlの代わりに'\n'を使用し、バッファリングを最大限に活用しましょう。

C++

// 低速：一行ごとにディスクアクセスが発生する可能性がある
for(int i=0; i<10000; ++i) {
    ofs << i << std::endl;
}

// 高速：バッファが一杯になるまでメモリ上で保持される
for(int i=0; i<10000; ++i) {
    ofs << i << '\n';
}

C++17/20におけるファイル操作の進化

モダンC++では、ファイルシステムの操作をより安全かつ直感的に行うための機能が追加されました。

C++17からはstd::filesystemライブラリが導入され、ディレクトリの作成やパスの操作が標準化されました。

パスの操作とファイルストリーム

ファイルを開く際に、パスが文字列である必要はなく、std::filesystem::pathオブジェクトを直接渡すことができます。

これにより、OSごとのパス区切り文字の違いを意識せずにコードを記述できるようになりました。

C++

#include <filesystem>
#include <fstream>

namespace fs = std::filesystem;

int main() {
    fs::path dir = "output_logs";
    // ディレクトリが存在しない場合は作成
    if (!fs::exists(dir)) {
        fs::create_directory(dir);
    }

    fs::path filepath = dir / "log_2026.txt";
    std::ofstream ofs(filepath);
    ofs << "C++17のfilesystemを使用した書き込みです。" << std::endl;
}

このように、ファイルそのものの操作だけでなく、周辺環境の整備も標準ライブラリで行えるようになったのは大きな進歩です。

C++23の新機能：std::print による新しい出力

2026年現在、最新のプロジェクトで活用され始めているのがC++23で導入された<print>ヘッダーです。

これまでのiostreamベースの出力は、書式設定が冗長になりやすく、コンパイル速度やバイナリサイズにも課題がありました。

C++23のstd::printおよびstd::printlnは、PythonのformatやRustのprintのように、簡潔で高速な出力を提供します。

std::println を使用したファイル書き込み

std::printlnは、標準出力だけでなく、第一引数にファイルポインタ（FILE*）を渡すことでファイルへの出力も可能です。

現状、std::ofstreamオブジェクトを直接渡すことはできませんが、C言語由来のfopenと組み合わせるか、将来的な拡張を見越した使い方が期待されています。

C++

#include <cstdio>
#include <print>

int main() {
    std::FILE* file = std::fopen("cpp23_output.txt", "w");
    if (!file) return 1;

    // C++23の型安全なフォーマット出力
    std::println(file, "Hello C++23! The value is {} and {}", 42, "Standard");

    std::fclose(file);
    return 0;
}

std::printは内部的にstd::formatの仕組みを利用しているため、浮動小数点数の精度指定や位置合わせが非常に簡潔に記述できます。

また、従来のiostreamに比べて処理のオーバーヘッドが少ないため、大量のテキスト生成において非常に有利です。

エラーハンドリングと堅牢なコード

ファイル書き込みは、ディスク容量の不足や権限の不足など、実行時の外部要因によって失敗する可能性が常にあります。

そのため、適切なエラーチェックを行うことが不可欠です。

例外処理の利用

fstreamはデフォルトでは例外を投げませんが、設定によって失敗時に例外を発生させるように変更できます。

C++

std::ofstream ofs;
ofs.exceptions(std::ios::failbit | std::ios::badbit);

try {
    ofs.open("protected_file.txt");
    ofs << "Writing data...";
} catch (const std::ios_base::failure& e) {
    std::cerr << "エラーが発生しました: " << e.what() << std::endl;
}

クリティカルなシステムでは、このように例外処理を組み込むことで、エラーの見落としを防ぐことができます。

大規模データの書き込みにおける非同期処理

さらに高度な手法として、GUIアプリケーションやリアルタイム性が求められるシステムでは、メインスレッドをブロックしない「非同期書き込み」が検討されます。

C++標準ライブラリには直接的な「非同期ファイルI/O」は存在しませんが、std::asyncやスレッドを組み合わせることで実現可能です。

ただし、複数のスレッドから同一のファイルに同時に書き込むと、データが混ざり合い破損する原因となるため、ミューテックス（std::mutex）による排他制御が必須となります。

実用的な例：CSV形式でのデータ保存

最後に、実戦でよく使われるCSV形式でのデータ出力を紹介します。

C++

#include <iostream>
#include <fstream>
#include <vector>

struct Record {
    int id;
    std::string name;
    double score;
};

void saveToCSV(const std::string& filename, const std::vector<Record>& records) {
    std::ofstream ofs(filename);
    
    // ヘッダーの書き込み
    ofs << "ID,Name,Score\n";
    
    for (const auto& r : records) {
        ofs << r.id << "," << r.name << "," << r.score << "\n";
    }
}

int main() {
    std::vector<Record> data = {
        {1, "Alice", 95.5},
        {2, "Bob", 82.0},
        {3, "Charlie", 88.0}
    };
    
    saveToCSV("results.csv", data);
    std::cout << "CSVファイルを保存しました。" << std::endl;
    return 0;
}

このコードでは、構造体のベクターをループで回し、カンマ区切りで書き出しています。

実務では、データ内にカンマや改行が含まれる場合の「クォート処理」なども必要になりますが、基本構造はこのようになります。