std::filesystem::filesystem_error

在标头 `<filesystem>` 定义
class filesystem_error;		(C++17 起)

类 std::filesystem::filesystem_error 定义由文件系统库中各函数的抛出版重载所抛出的异常对象。

继承图

成员函数

(构造函数)	构造异常对象 (公开成员函数)
operator=	替换异常对象 (公开成员函数)
path1path2	返回导致错误的操作所涉及的路径 (公开成员函数)
what	返回解释性字符串 (公开成员函数)

继承自 std::system_error

成员函数

code	返回错误码 (`std::system_error` 的公开成员函数)
what [虚]	返回解释性字符串 (`std::system_error` 的虚公开成员函数)

继承自 std::runtime_error

继承自 std::exception

成员函数

(析构函数) [虚]	销毁该异常对象 (`std::exception` 的虚公开成员函数)
what [虚]	返回解释性字符串 (`std::exception` 的虚公开成员函数)

注解

为确保 filesystem_error 的复制函数为 noexcept，典型实现将保有 what() 的返回值的对象和 path1() 与 path2() 所分别引用的两个 std::filesystem::path 对象存储于分离分配的引用计数存储。

当前 MS STL 实现不合标准：上述对象被直接存储在 filesystem 对象中，这使得复制函数不是 noexcept。

示例

运行此代码

#include <filesystem>
#include <iostream>
#include <system_error>
 
int main()
{
    const std::filesystem::path from{"/none1/a"}, to{"/none2/b"};
 
    try
    {
        std::filesystem::copy_file(from, to); // 抛出：文件不存在
    }
    catch (std::filesystem::filesystem_error const& ex)
    {
        std::cout << "what():  " << ex.what() << '\n'
                  << "path1(): " << ex.path1() << '\n'
                  << "path2(): " << ex.path2() << '\n'
                  << "code().value():    " << ex.code().value() << '\n'
                  << "code().message():  " << ex.code().message() << '\n'
                  << "code().category(): " << ex.code().category().name() << '\n';
    }
 
    // 所有函数都有无抛出等价物
    std::error_code ec;
    std::filesystem::copy_file(from, to, ec); // 不抛出
    std::cout << "\n不抛出形式设置的 error_code: " << ec.message() << '\n';
}

可能的输出：

what():  filesystem error: cannot copy file: No such file or directory [/none1/a] [/none2/b]
path1(): "/none1/a"
path2(): "/none2/b"
code().value():    2
code().message():  No such file or directory
code().category(): generic
 
不抛出形式设置的 error_code: No such file or directory

编译器支持
自立实现与有宿主实现
语言
标准库
标准库标头
具名要求
功能特性测试宏 (C++20)
语言支持库
概念库 (C++20)
元编程库 (C++11)
诊断库
通用工具库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
并发支持库 (C++11)
技术规范
符号索引
外部库

成员函数
filesystem_error::filesystem_error
filesystem_error::operator=
filesystem_error::path1filesystem_error::path2
filesystem_error::what
继承自 std::system_error
system_error::code

std::filesystem::filesystem_error

成员函数

继承自 std::system_error

成员函数

继承自 std::runtime_error

继承自 std::exception

成员函数

注解

示例

导航