最終更新日時: 2025年07月14日 21時13分27秒 (JST)
Koichi Murase が更新

履歴 編集

function
<filesystem>

# std::filesystem::is_block_file(C++17)

    namespace std::filesystem {
      bool is_block_file(file_status s) noexcept;                      // (1)
      bool is_block_file(const path& p);                               // (2)
      bool is_block_file(const path& p, std::error_code& ec) noexcept; // (3)
    }

## 概要

指定されたパスがブロックデバイスのスペシャルファイルを指しているかを確認する。

Linux環境においては、`/dev/disk0`、`/dev/sda`、`/dev/loop0`などがブロックデバイスに該当する。

## 戻り値

- (1) : `return s.type() == file_type::block;`
- (2) : `return is_block_file(status(p));`
- (3) :

      file_status s = status(p, ec);
      return is_block_file(s);

## 例外

- (1) : 投げない
- (2) : ファイルシステムがエラーを報告する場合がある。それに加えて、指定されたファイルの種別が`file_type::none`、`file_type::not_found`、`file_type::unknown`のいずれかである場合もエラーである。エラーが発生した場合は、`std::filesystem::filesystem_error` 例外を送出する
- (3) : 投げない

## 例

### Linux環境の例

    #include <cassert>
    #include <filesystem>

    namespace fs = std::filesystem;

    int main()
    {
      // (1)
      // 取得済みのファイル状態を使用して、ブロックスペシャルファイルかを確認
      assert(fs::is_block_file(fs::status("/dev/disk0")));

      // (2)
      // パスを指定して、ブロックスペシャルファイルかを確認。
      assert(fs::is_block_file("/dev/disk0"));
      assert(fs::is_block_file("/dev/sda"));
      assert(fs::is_block_file("/dev/loop0"));

      // (3)
      // エラー情報を例外ではなくerror_codeで受け取る
      std::error_code ec;
      bool result = fs::is_block_file("/dev/disk0", ec);
      assert(!ec);
      assert(result);
    }

#### 出力

## バージョン

### 言語

- C++17

### 処理系

- Clang: 7.0 ✅
- GCC: 8.1 ✅
- Visual C++: