std::filesystem::directory_entry::exists

 
C++
 
文件系统库
类
函数
文件类型
 
std::filesystem::directory_entry
directory_entry::exists
(C++20 前)(C++20 前)(C++20 前)(C++20 前)(C++20 前)(C++20)
 
bool exists() const;
bool exists( std::error_code& ec ) const noexcept;
 (C++17 起)

检查所指的对象是否存在。各自等效于返回 std::filesystem::exists(status()) 或 std::filesystem::exists(status(ec))

参数

ec - 不抛出重载中报告错误的输出参数

返回值

若被指代文件系统对象存在则为 true。

异常

不接受 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 <fstream>
#include <iostream>
#include <string>
 
namespace fs = std::filesystem;
 
int main()
{
    // 存储当前路径以在退出时恢复
    const auto old_current_path = fs::current_path();
 
    // 在临时目录中创建 "sanbox" 目录
    const auto dir_sandbox = fs::temp_directory_path() / "sandbox";
 
    if (!fs::create_directory(dir_sandbox)) {
        std::cout << "ERROR #1" << '\n';
        return -1;
    }
 
    fs::current_path(dir_sandbox); // 切换到新创建的目录
 
    fs::directory_entry entry_sandbox { dir_sandbox };
    if (!entry_sandbox.exists()) {
        std::cout << "ERROR #2" << '\n';
        return -1;
    }
 
    std::cout << "Current dir: " << entry_sandbox.path().filename() << '\n';
 
    fs::path path_tmp_file = dir_sandbox / "tmp_file";
 
    std::ofstream file( path_tmp_file.string() ); // 创建常规文件
    file << "apiref.com"; // 写 16 字节
    file.flush();
 
    fs::directory_entry entry_tmp_file{ path_tmp_file };
 
    if (entry_tmp_file.exists()) {
        std::cout << "File " << entry_tmp_file.path().filename()
                  << " has size: " << entry_tmp_file.file_size() << '\n';
    } else {
        std::cout << "ERROR #3" << '\n';
    }
 
    // 清理
    fs::current_path(old_current_path);
    fs::remove_all(dir_sandbox);
}

可能的输出： 

Current dir: "sandbox"
File "tmp_file" has size: 16

参阅

(C++17)
 检查路径是否指代既存的文件系统对象
(函数)