C/C++编程：无格式输出函数

淡淡的烟草味﹌ 2022-05-17 03:28 306阅读 0赞

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

*  构造一个具有自动存储期的[basic\_ostream::sentry][basic_ostream_sentry]类型的对象，它进行下列操作：

1.  若输出流上设置了 [eofbit][] 或 [badbit][eofbit]，则一同设置 `failbit`，且若此输出流的异常掩码中启用了 failbit 上的异常，则抛出 [ios\_base::failure][ios_base_failure]。
2.  刷新其所 tie() 的输出流，若适用。

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

1.  若输出中抛出了异常，则设置输出流中的 `badbit`。若此流的异常掩码中启用了 badbit 上的异常，则亦会重抛这个异常
2.  若不抛异常，则返回该函数所指定的值。

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

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

*  [basic\_ostream::operator<<(basic\_streambuf\*)][basic_ostream_operator_basic_streambuf]
 *  [basic\_ostream::put][basic_ostream_put]
 *  [basic\_ostream::write][basic_ostream_write]
 *  [basic\_ostream::flush][basic_ostream_flush]
 *  [basic\_ostream::tellp][basic_ostream_tellp] （但其调用 pubseekoff 而非进行输出）
 *  [basic\_ostream::seekp][basic_ostream_seekp] （但其调用 pubseekoff 或 pubseekpos 而非进行输出）

[basic_ostream_sentry]: https://zh.cppreference.com/w/cpp/io/basic_ostream/sentry
[eofbit]: https://zh.cppreference.com/w/cpp/io/ios_base/iostate
[ios_base_failure]: https://zh.cppreference.com/w/cpp/io/ios_base/failure
[basic_ios_good]: https://zh.cppreference.com/w/cpp/io/basic_ios/good
[std_basic_streambuf]: https://zh.cppreference.com/w/cpp/io/basic_streambuf
[basic_ostream_operator_basic_streambuf]: https://zh.cppreference.com/w/cpp/io/basic_ostream/operator_ltlt
[basic_ostream_put]: https://zh.cppreference.com/w/cpp/io/basic_ostream/put
[basic_ostream_write]: https://zh.cppreference.com/w/cpp/io/basic_ostream/write
[basic_ostream_flush]: https://zh.cppreference.com/w/cpp/io/basic_ostream/flush
[basic_ostream_tellp]: https://zh.cppreference.com/w/cpp/io/basic_ostream/tellp
[basic_ostream_seekp]: https://zh.cppreference.com/w/cpp/io/basic_ostream/seekp