C++ 概念： FormattedOutputFunction

 

C++

语言

标准库头文件

概念

工具库

字符串库

容器库

算法库

迭代器库

数值库

输入/输出库

本地化库

正则表达式库 (C++11)

原子操作库 (C++11)

线程支持库 (C++11)

文件系统库 (C++17)

技术规范

 

C++ 概念

基础
可默认构造 可复制赋值 可复制构造	可移动赋值 (C++11) 可移动构造 (C++11) 可析构
布局
平凡类型 (C++11) 可平凡复制 (C++11)	标准布局类型 (C++11) POD 类型
库所属
可比较相等 可比较小于 可交换 (C++11) 可值交换 (C++11)	可空指针 (C++11) 哈希 (C++11) 分配器
容器
容器 顺序容器 相接容器 (C++17) 可逆容器	关联容器 具分配器容器 无序关联容器 (C++11)
容器元素
可默认插入 (C++11) 可复制插入 (C++11) 可移动插入 (C++11)	可原位构造 (C++11) 可擦除 (C++11)
迭代器
迭代器 输出迭代器 输入迭代器	向前迭代器 双向迭代器 随机访问迭代器 相接迭代器 (C++17)
流 I/O
有格式输入函数 无格式输入函数	有格式输出函数 无格式输出函数
随机数
种子序列 (C++11) 随机数引擎 (C++11)	随机数分布 (C++11) 均匀随机位生成器 (C++11) 随机数引擎适配器 (C++11)
并发
基础可锁 (C++11) 可锁 (C++11) 定时可锁 (C++11)	互斥 (C++11) 定时互斥 (C++11) 共享互斥 (C++17) 共享定时互斥 (C++14)
其他
字符特性 pos_type off_type 时钟 (C++11) 位掩码类型	一元类型特性 (C++11) 二元类型特性 (C++11) 变换特性 (C++11) 平凡时钟 (C++11) 字面类型 (C++11)

 

要求

有格式输出函数 (FormattedOutputFunction) 是进行下列操作的流输出函数：

• 构造拥有自动存储期的 basic_ostream::sentry类型对象，这进行下列操作

• 若输出流上设置了 eofbit 或 badbit ，则一并设置 failbit ，而若此输出流的异常掩码中启用了 failbit 上的异常，则抛出 ios_base::failure 。
• 冲入 tie() 过的输出流，若可应用。

• 以调用 sentry::operator bool() 检查 sentry 的状态，等价于 basic_ios::good 。
• 若 sentry 返回 false 或 sentry 的构造函数抛异常，则不发生输出
• 若 sentry 返回 true ，则试图通过插入字符到输出流进行所欲的输出，如同以调用 rdbuf()->sputc() 或 rdbuf()->xsputn() 。另外，可能调用 rdbuf()->overflow() 或 rdbuf()->sync() ，但不会调用 std::basic_streambuf 的其他虚成员函数。

• 若无法生成输出，则设置 failbit 。若此流的异常掩码中启用了 failbit 上的异常，则抛出 ios_base::failure 。
• 若输出中抛出异常，则设置输出流中的 badbit 。若此流的异常掩码中启用了 badbit 上的异常，则亦会重抛该异常。
• 若未抛异常，则返回 *this 。

• 任何事件中，无论是因异常终止还是返回，都会在离开此函数前调用 sentry 的析构函数。

标准库

下列标准库函数是有格式输出函数 (FormattedOutputFunction) 。

• basic_ostream::operator<<(int, long, double, void*, bool)
• operator<<(std::basic_ostream, char)
• operator<<(std::basic_ostream, char*)
• operator<<(std::basic_ostream, std::bitset)
• operator<<(std::basic_ostream, std::string)
• operator<< ，在 std::put_money 的返回值上调用时。