std::filesystem::is_regular_file(C++17)

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

概要

指定されたパスが通常ファイルを指しているかを確認する。

戻り値

(1) : return s.type() == file_type::regular;
(2) : return is_regular_file(status(p));

(3) :

file_status s = status(p, ec);
if (ec) {
  return false;
}

// ファイルが見つからなかったらエラー
file_type type = s.type();
if (type == file_type::none || file_type::not_found || file_type::unknown) {
  ec = implementation-defined;
  return false;
}
ec.clear();
return is_regular_file(s);

例外

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

例

#include <cassert>
#include <fstream>
#include <filesystem>

namespace fs = std::filesystem;

int main()
{
  std::ofstream{"regular.txt"};
  fs::create_symlink("regular.txt", "regular.symlink");
  fs::create_directory("dir");

  // (1)
  // 取得済みのファイル状態を使用して、通常ファイルかを確認
  assert(fs::is_regular_file(fs::status("regular.txt")));

  // (2)
  // パスを指定して、通常ファイルかを確認。
  // シンボリックリンクはリンク先ファイルで判定される
  assert(fs::is_regular_file("regular.txt"));
  assert(fs::is_regular_file("regular.symlink"));
  assert(!fs::is_regular_file("dir"));

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

std::filesystem::is_regular_file(C++17)

概要

戻り値

例外

例

出力

バージョン

言語

処理系