std::filesystem::directory_entry::is_regular_file
< cpp | filesystem | directory entry
bool is_regular_file() const; bool is_regular_file( std::error_code& ec ) const noexcept; |
(C++17 起) | |
检查所指的对象是否常规文件。各等效于返回 std::filesystem::is_regular_file(status()) 或 std::filesystem::is_regular_file(status(ec))
参数
ec | - | 不抛出重载中报告错误的输出参数 |
返回值
若所指代文件系统对象为常规文件,则为 true ,否则为 false 。
异常
不接受 std::error_code& 参数的重载在底层 OS API 错误时抛出 filesystem_error ,以第一 path 参数 p
和作为错误码参数的 OS 错误码构造。若 OS API 调用失败,则接受 std::error_code& 参数的重载设置该参数为 OS API 错误码,而若不出现错误则执行 ec.clear() 。若内存分配失败,则任何不标记为 noexcept
的重载可能抛出 std::bad_alloc 。
示例
运行此代码
#include <filesystem> #include <iostream> #include <string> namespace fs = std::filesystem; int main(int argc, const char* argv[]) { // 打印出目录 'dir' 中的所有常规文件。 try { const auto dir = argc == 2 ? fs::path{ argv[1] } : fs::current_path(); std::cout << "Current dir: " << dir << '\n' << std::string(40, '-') << '\n'; for (fs::directory_entry const& entry : fs::directory_iterator(dir)) { if (entry.is_regular_file()) { std::cout << entry.path().filename() << '\n'; } } } catch(fs::filesystem_error const& e) { std::cout << e.what() << '\n'; } }
可能的输出:
Current dir: "/tmp/1588616534.9884143" ---------------------------------------- "main.cpp" "a.out"
参阅
(C++17) |
检查参数是否表示一个常规文件 (函数) |