C++でファイルの存在確認を行う方法：std::filesystem::existsの実装と注意点

2026年5月8日

入出力・ファイル操作

C++において、ファイルやディレクトリの存在を確認する作業は、ファイル操作を伴うアプリケーション開発において避けては通れない基本的な処理の一つです。

以前のC++規格では、標準ライブラリだけでプラットフォームに依存せずにファイルの存在を確認するスマートな方法が不足しており、開発者はOS固有のAPIや古いC言語の関数を併用することを余儀なくされてきました。

しかし、現代のC++開発においては、標準ライブラリの拡充により、移植性が高く安全なコードを容易に記述できるようになっています。

本記事では、C++17以降で導入されたstd::filesystemライブラリを中心に、ファイルの存在確認を行うための具体的な実装方法と、実務で注意すべき点について詳しく解説します。

開発効率を向上させ、堅牢なプログラムを構築するための知識として、最新の標準仕様に基づいたテクニックを整理していきましょう。

目次 [ close ]

C++標準ライブラリによるファイル存在確認の基本

現代のC++において、ファイルの存在を確認する最も標準的かつ推奨される方法は、std::filesystem::exists関数を使用することです。

この関数はC++17規格で導入され、ファイルシステム上のパスが実在するかどうかを真偽値で返します。

利用するためには、<filesystem>ヘッダーをインクルードする必要があります。

まずは、最もシンプルな実装例を見てみましょう。

C++

// std::filesystem::existsを使用した基本的な例
#include <iostream>
#include <filesystem>

namespace fs = std::filesystem;

int main() {
    // 確認したいファイルパスを指定
    fs::path filePath = "example.txt";

    // ファイルが存在するか確認
    if (fs::exists(filePath)) {
        std::cout << "指定されたファイルは存在します。" << std::endl;
    } else {
        std::cout << "指定されたファイルは見つかりません。" << std::endl;
    }

    return 0;
}

実行結果

指定されたファイルは存在します。

このコードでは、fs::pathオブジェクトを作成し、それをfs::existsに渡すだけでチェックが完了します。

非常に直感的であり、WindowsやLinuxといったOSの違いを意識せずに記述できる点が大きなメリットです。

std::filesystem::existsは、通常のファイルだけでなく、ディレクトリ（フォルダ）の存在確認にも使用可能です。

std::filesystem::existsの戻り値と挙動

std::filesystem::exists関数は、パスが存在し、かつその存在が確認できた場合にtrueを返します。

ここで注意が必要なのは、「存在しない場合」と「エラーが発生した場合」の扱いです。

パスが物理的に存在しない場合、関数は当然falseを返します。

しかし、権限不足などでファイルシステムの状態を取得できない場合、デフォルトではstd::filesystem::filesystem_error例外がスローされます。

プログラムのクラッシュを避けるためには、例外処理を適切に行うか、エラーコードを受け取るオーバーロードを使用する必要があります。

エラーハンドリング：例外とエラーコードの使い分け

実務的なアプリケーションでは、ファイルが存在しないこと自体はエラーではなく、単なる状態の一つとして扱われることが多いです。

一方で、ディスクの不具合やアクセス権限の欠如などは、例外的に処理すべき事象となります。

例外をキャッチする方法

最も基本的なエラーハンドリングは、try-catchブロックを使用する方法です。

C++

#include <iostream>
#include <filesystem>

namespace fs = std::filesystem;

void checkFile(const std::string& pathStr) {
    try {
        if (fs::exists(pathStr)) {
            std::cout << "ファイルが存在します: " << pathStr << std::endl;
        } else {
            std::cout << "ファイルが存在しません: " << pathStr << std::endl;
        }
    } catch (const fs::filesystem_error& e) {
        // アクセス拒否などのエラーが発生した場合の処理
        std::cerr << "エラーが発生しました: " << e.what() << std::endl;
    }
}

この方法は、プログラムのどこでエラーが発生したかを明確に追跡したい場合に適しています。

std::error_codeを使用する方法

例外を発生させたくないパフォーマンス重視の場面では、std::error_codeを引数に渡す設計が推奨されます。

C++

#include <iostream>
#include <filesystem>
#include <system_error>

namespace fs = std::filesystem;

int main() {
    std::error_code ec;
    fs::path p = "/root/secret.txt";

    if (fs::exists(p, ec)) {
        std::cout << "ファイルにアクセス可能です。" << std::endl;
    } else {
        if (ec) {
            // ecが真の場合、存在しないのではなくエラーが発生している
            std::cerr << "アクセスエラー: " << ec.message() << std::endl;
        } else {
            std::cout << "ファイルが存在しません。" << std::endl;
        }
    }
    return 0;
}

このオーバーロードを使用すると、関数は例外を投げず、エラーの詳細はecオブジェクトに格納されます。

条件分岐だけでエラー処理を完結できるため、コードの見通しが良くなるケースが多いです。

ファイルとディレクトリを区別して確認する

std::filesystem::existsは「何かがそのパスにあること」を教えてくれますが、それが「ファイル」なのか「ディレクトリ」なのかは区別しません。

特定の用途では、ディレクトリではなく「ファイル」として存在していることを確認したい場合があります。

std::filesystem::is_regular_fileの活用

パスがファイルであることを確認するには、is_regular_fileを使用します。

C++

#include <iostream>
#include <filesystem>

namespace fs = std::filesystem;

void validatePath(const fs::path& p) {
    if (fs::is_regular_file(p)) {
        std::cout << "これは通常のファイルです。" << std::endl;
    } else if (fs::is_directory(p)) {
        std::cout << "これはディレクトリです。" << std::endl;
    } else {
        std::cout << "ファイル・ディレクトリ以外の特殊なパス、または存在しません。" << std::endl;
    }
}

is_regular_fileも内部で存在確認を行うため、これ単体で「存在し、かつファイルであること」を確認できます。

同様にディレクトリ専用のis_directoryも活用することで、より厳密なバリデーションが可能になります。

注意点：TOCTOU（Time-of-Check to Time-of-Use）問題

ファイルシステムの操作において非常に重要な概念が、TOCTOU（トキトウ）と呼ばれる競合状態のリスクです。

これは、「存在を確認した瞬間」と「実際にファイルを開く瞬間」の間に、別のプロセスによってファイルが削除されたり変更されたりする可能性を指します。

C++

// 危険なコードの例
if (fs::exists("data.txt")) {
    // この隙間にファイルが削除される可能性がある
    std::ifstream ifs("data.txt");
    // 処理...
}

セキュリティや堅牢性が求められるプログラムでは、存在確認を行ってから開くのではなく、「まず開いてみて、失敗した場合にエラー処理を行う」というアプローチが推奨されます。

ファイルを開く操作そのものが、存在確認と排他的なアクセスを兼ねるため、競合状態を防ぐことができます。

代替手段：古いC++や特定のユースケースでの方法

C++17が利用できないレガシーなプロジェクトや、特定の要件がある場合には、他の方法が使われることもあります。

std::ifstreamを使用する方法

ファイル入力ストリームを使用して、ファイルが開けるかどうかで存在を確認する手法です。

C++

#include <fstream>

bool fileExistsLegacy(const std::string& filename) {
    std::ifstream ifs(filename);
    return ifs.good();
}

この方法は非常にシンプルですが、「ファイルは存在するが、他のプロセスが読み取り専用でロックしている」場合などに、誤ってfalseを返す可能性があります。

単なる存在確認としては不正確になるケースがあるため、現在では推奨されません。

C言語のstat関数を使用する方法

POSIX準拠のシステムやWindowsのランタイムライブラリに含まれるstat関数を使用する方法です。

C++

#include <sys/stat.h>

bool fileExistsStat(const std::string& name) {
    struct stat buffer;
    return (stat(name.c_str(), &buffer) == 0);
}

これは非常に高速ですが、C言語スタイルの構造体管理が必要であり、コードが煩雑になりがちです。

また、文字コード（UTF-8やWide Char）の扱いでプラットフォームごとの差異が出やすいため、最新のC++であればstd::filesystemに移行すべきです。

各手法の比較まとめ

ファイル存在確認における主要な手法の特性を、以下の表にまとめました。

手法	標準規格	推奨度	メリット	デメリット
std::filesystem::exists	C++17	高	標準的、クロスプラットフォーム、多機能	C++17以降が必要
std::ifstream::good	C++98	低	古い環境でも動作する	権限やロックによる誤判定がある
stat / access	C標準 / POSIX	中	高速、OSレベルの制御が可能	コードが複雑、移植性の管理が必要

基本的にはstd::filesystem::existsを選択し、特殊なパフォーマンス要件や古い環境制約がある場合のみ、他の手法を検討するのが最善です。

実用的な応用例：存在しない場合のみディレクトリを作成する

実務では、設定ファイルやログファイルを保存する前に、保存先ディレクトリが存在するか確認し、なければ作成するという処理が頻出します。

C++

#include <iostream>
#include <filesystem>

namespace fs = std::filesystem;

void prepareDirectory(const std::string& dirPath) {
    std::error_code ec;
    
    if (!fs::exists(dirPath, ec)) {
        // ディレクトリが存在しないので作成する
        if (fs::create_directories(dirPath, ec)) {
            std::cout << "ディレクトリを作成しました: " << dirPath << std::endl;
        } else {
            std::cerr << "作成に失敗しました: " << ec.message() << std::endl;
        }
    } else {
        std::cout << "ディレクトリは既に存在します。" << std::endl;
    }
}

create_directories関数は、中間ディレクトリを含めて一気に作成してくれるため、非常に便利です。

ここでもstd::error_codeを利用することで、予期せぬエラーによるプログラムの中断を防いでいます。