ファイル

[C++] ファイルが存在するか確認する方法を解説 – filesystem::exists()

C++17以降では、標準ライブラリの<filesystem>を使用してファイルやディレクトリの存在を確認できます。

std::filesystem::exists()関数を用いることで、指定したパスが存在するかを簡単にチェック可能です。

この関数は、ファイルだけでなくディレクトリの存在も確認できます。

パスはstd::filesystem::path型で指定し、戻り値はtrue(存在する場合)またはfalse(存在しない場合)です。

目次から探す

filesystem::exists()の基本的な使い方
実際のコード例
応用的な使い方
注意点とベストプラクティス
まとめ

filesystem::exists()の基本的な使い方

C++17から追加された<filesystem>ライブラリを使用すると、ファイルやディレクトリの存在を簡単に確認できます。

filesystem::exists()関数は、指定したパスが存在するかどうかを判定するための便利な関数です。

以下に基本的な使い方を示します。

#include <iostream>
#include <filesystem> // filesystemライブラリをインクルード
int main() {
    std::string path = "test.txt"; // 確認したいファイルのパスを指定
    // ファイルの存在を確認
    if (std::filesystem::exists(path)) {
        std::cout << "ファイルは存在します。" << std::endl; // 存在する場合のメッセージ
    } else {
        std::cout << "ファイルは存在しません。" << std::endl; // 存在しない場合のメッセージ
    }
    return 0; // プログラムの終了
}

ファイルは存在します。

このコードでは、test.txtというファイルが存在するかどうかを確認しています。

filesystem::exists()関数がtrueを返すと、ファイルが存在することを示すメッセージが表示されます。

存在しない場合は、その旨のメッセージが表示されます。

実際のコード例

filesystem::exists()を使用した実際のコード例をいくつか紹介します。

これにより、さまざまなシナリオでのファイルやディレクトリの存在確認がどのように行われるかを理解できます。

1. ファイルの存在確認

以下のコードは、特定のファイルが存在するかどうかを確認する例です。

#include <iostream>
#include <filesystem> // filesystemライブラリをインクルード
int main() {
    std::string filePath = "example.txt"; // 確認したいファイルのパスを指定
    // ファイルの存在を確認
    if (std::filesystem::exists(filePath)) {
        std::cout << "ファイル '" << filePath << "' は存在します。" << std::endl;
    } else {
        std::cout << "ファイル '" << filePath << "' は存在しません。" << std::endl;
    }
    return 0; // プログラムの終了
}

ファイル 'example.txt' は存在します。

2. ディレクトリの存在確認

次に、ディレクトリが存在するかどうかを確認する例です。

#include <iostream>
#include <filesystem> // filesystemライブラリをインクルード
int main() {
    std::string dirPath = "my_directory"; // 確認したいディレクトリのパスを指定
    // ディレクトリの存在を確認
    if (std::filesystem::exists(dirPath)) {
        std::cout << "ディレクトリ '" << dirPath << "' は存在します。" << std::endl;
    } else {
        std::cout << "ディレクトリ '" << dirPath << "' は存在しません。" << std::endl;
    }
    return 0; // プログラムの終了
}

ディレクトリ 'my_directory' は存在します。

3. 相対パスと絶対パスの使用

相対パスと絶対パスを使用してファイルの存在を確認する例です。

#include <iostream>
#include <filesystem> // filesystemライブラリをインクルード
int main() {
    std::string relativePath = "data/file.txt"; // 相対パス
    std::string absolutePath = "/home/user/data/file.txt"; // 絶対パス
    // 相対パスのファイルの存在を確認
    if (std::filesystem::exists(relativePath)) {
        std::cout << "相対パスのファイル '" << relativePath << "' は存在します。" << std::endl;
    } else {
        std::cout << "相対パスのファイル '" << relativePath << "' は存在しません。" << std::endl;
    }
    // 絶対パスのファイルの存在を確認
    if (std::filesystem::exists(absolutePath)) {
        std::cout << "絶対パスのファイル '" << absolutePath << "' は存在します。" << std::endl;
    } else {
        std::cout << "絶対パスのファイル '" << absolutePath << "' は存在しません。" << std::endl;
    }
    return 0; // プログラムの終了
}

相対パスのファイル 'data/file.txt' は存在します。
絶対パスのファイル '/home/user/data/file.txt' は存在しません。

これらの例を通じて、filesystem::exists()を使ったファイルやディレクトリの存在確認の方法を理解できるでしょう。

応用的な使い方

filesystem::exists()関数は、ファイルやディレクトリの存在確認だけでなく、さまざまな応用が可能です。

ここでは、いくつかの応用的な使い方を紹介します。

1. ファイルの存在確認と作成

ファイルが存在しない場合に新たに作成する例です。

#include <iostream>
#include <filesystem> // filesystemライブラリをインクルード
#include <fstream>    // fstreamライブラリをインクルード
int main() {
    std::string filePath = "new_file.txt"; // 確認したいファイルのパスを指定
    // ファイルの存在を確認
    if (!std::filesystem::exists(filePath)) {
        std::ofstream file(filePath); // ファイルを作成
        file << "新しいファイルが作成されました。" << std::endl; // 内容を書き込む
        file.close(); // ファイルを閉じる
        std::cout << "ファイル '" << filePath << "' を作成しました。" << std::endl;
    } else {
        std::cout << "ファイル '" << filePath << "' は既に存在します。" << std::endl;
    }
    return 0; // プログラムの終了
}

ファイル 'new_file.txt' を作成しました。

2. ディレクトリの存在確認と作成

指定したディレクトリが存在しない場合に新たに作成する例です。

#include <iostream>
#include <filesystem> // filesystemライブラリをインクルード
int main() {
    std::string dirPath = "new_directory"; // 確認したいディレクトリのパスを指定
    // ディレクトリの存在を確認
    if (!std::filesystem::exists(dirPath)) {
        std::filesystem::create_directory(dirPath); // ディレクトリを作成
        std::cout << "ディレクトリ '" << dirPath << "' を作成しました。" << std::endl;
    } else {
        std::cout << "ディレクトリ '" << dirPath << "' は既に存在します。" << std::endl;
    }
    return 0; // プログラムの終了
}

ディレクトリ 'new_directory' を作成しました。

3. 複数のファイルの存在確認

複数のファイルの存在を一度に確認する例です。

#include <iostream>
#include <filesystem> // filesystemライブラリをインクルード
#include <vector>    // vectorライブラリをインクルード
int main() {
    std::vector<std::string> files = {"file1.txt", "file2.txt", "file3.txt"}; // 確認したいファイルのリスト
    for (const auto& file : files) {
        // ファイルの存在を確認
        if (std::filesystem::exists(file)) {
            std::cout << "ファイル '" << file << "' は存在します。" << std::endl;
        } else {
            std::cout << "ファイル '" << file << "' は存在しません。" << std::endl;
        }
    }
    return 0; // プログラムの終了
}

ファイル 'file1.txt' は存在します。
ファイル 'file2.txt' は存在しません。
ファイル 'file3.txt' は存在します。

4. ファイルの存在確認と削除

ファイルが存在する場合に削除する例です。

#include <iostream>
#include <filesystem> // filesystemライブラリをインクルード
int main() {
    std::string filePath = "old_file.txt"; // 確認したいファイルのパスを指定
    // ファイルの存在を確認
    if (std::filesystem::exists(filePath)) {
        std::filesystem::remove(filePath); // ファイルを削除
        std::cout << "ファイル '" << filePath << "' を削除しました。" << std::endl;
    } else {
        std::cout << "ファイル '" << filePath << "' は存在しません。" << std::endl;
    }
    return 0; // プログラムの終了
}

ファイル 'old_file.txt' を削除しました。

これらの応用例を通じて、filesystem::exists()を活用したさまざまな操作が可能であることが理解できるでしょう。

ファイルやディレクトリの管理を効率的に行うために、これらのテクニックを活用してください。

注意点とベストプラクティス

filesystem::exists()を使用する際には、いくつかの注意点やベストプラクティスがあります。

これらを理解しておくことで、より安全で効率的なプログラムを作成できます。

1. パスの形式に注意

相対パスと絶対パス: 相対パスを使用する場合、現在の作業ディレクトリに依存します。

プログラムの実行環境によって異なる結果になる可能性があるため、必要に応じて絶対パスを使用することを検討してください。

パスの区切り文字: WindowsとUnix系システムではパスの区切り文字が異なります。

std::filesystem::pathを使用することで、プラットフォームに依存しないパスの操作が可能です。

2. エラーハンドリング

例外処理: filesystem::exists()は、無効なパスやアクセス権限の問題がある場合に例外をスローすることがあります。

これを適切に処理するために、try-catchブロックを使用することが推奨されます。

try {
    if (std::filesystem::exists("path/to/file.txt")) {
        // ファイルが存在する場合の処理
    }
} catch (const std::filesystem::filesystem_error& e) {
    std::cerr << "エラー: " << e.what() << std::endl; // エラーメッセージを表示
}