std::format_error

< cpp‎ | utility‎ | format
 
C++
 
工具库
通用工具
日期和时间
函数对象
格式化库 (C++20)
(C++11)
(C++14)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)(C++20)(C++20)(C++20)(C++20)(C++20)
(C++20)
swap 与类型运算
(C++20)
(C++14)
(C++11)
(C++11)
(C++11)
(C++11)
(C++17)
常用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)

初等字符串转换
(C++17)
(C++17)
(C++17)
 
格式化库
格式化函数
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
格式化器
(C++20)
(C++20)(C++20)(C++20)
(C++20)(C++20)(C++20)
格式化参数
(C++20)
(C++20)(C++20)(C++20)(C++20)
(C++20)
(C++20)(C++20)
格式错误
format_error
(C++20)
 
定义于头文件 <format>
class format_error;
 (C++20 起)

定义抛出以报告格式化库中错误的异常对象类型。

cpp/error/exceptioncpp/error/runtime errorstd-format error-inheritance.svg

继承图

成员函数

(构造函数)
 构造拥有给定消息的新 format_error 对象
(公开成员函数)
operator=
 替换 format_error 对象
(公开成员函数)
what
 返回解释字符串
(公开成员函数)

std::format_error::format_error

format_error( const std::string& what_arg );
 (1) (C++20 起)
format_error( const char* what_arg );
 (2) (C++20 起)
format_error( const format_error& other ) noexcept;
 (3) (C++20 起)
1-2) 构造以 what_arg 为解释字符串的异常对象，解释字符串能通过 what() 访问。
3) 复制构造函数。若 *this 与 other 均拥有动态类型 std::format_error 则 std::strcmp(what(), other.what()) == 0 。

参数

what_arg - 解释字符串
other - 要复制的另一异常对象

异常

1-2) 可能抛出 std::bad_alloc

注解

因为不容许复制 std::format_error 抛出异常，通常将此消息在内部存储为分离分配的引用计数字符串。这也是构造函数不接收 std::string&& 参数的理由：无论如何它必须复制内容。

std::format_error::operator=

format_error& operator=( const format_error& other ) noexcept;
 (C++20 起)

以 other 的内容赋值。若 *this 与 other 均拥有动态类型 std::format_error 则赋值后 std::strcmp(what(), other.what()) == 0 。

参数

other - 用以赋值的另一异常对象

返回值

*this

std::format_error::what

virtual const char* what() const noexcept;
 (C++20 起)

返回解释字符串。

参数

（无）

返回值

指向有解释信息的空终止字符串的指针。该字符串适合转换并显示为 std::wstring 。保证该指针至少到获得它来源的异常对象被销毁，或在该异常对象上调用非 const 成员函数（例如复制赋值运算符）为止合法。

注解

允许但不要求实现覆写 what() 。

继承自 std::runtime_error


继承自 std::exception

成员函数

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

示例

本节未完成
原因：暂无示例

参阅