C++ 具名要求：无格式输出函数 (UnformattedOutputFunction)

来自cppreference.com
< cpp‎ | named req
 
C++
 
C++ 具名要求
基础
类型属性
库所属
容器
容器元素
迭代器
流 I/O
UnformattedOutputFunction
随机数
并发
(C++11)
(C++11)
(C++17)
(C++14)
其他
 

要求

无格式输出函数 (UnformattedOutputFunction) 是进行下列操作的流输入函数：

  • 若输出流上设置了 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 的其他虚函数。
  • 若输出中抛出了异常，则设置输出流中的 badbit。若此流的异常掩码中启用了 badbit 上的异常，则亦会重抛这个异常。
  • 若不抛异常，则返回该函数所指定的值。
  • 任何事件中，无论是因异常终止还是返回，离开此函数前都会调用 sentry 的析构函数。

标准库

下列标准库函数是无格式输出函数 (UnformattedOutputFunction) 。

(C++11 起)
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/named_req/UnformattedOutputFunction&oldid=61669”