std::basic_ostream<CharT,Traits>::sentry
来自cppreference.com
< cpp | io | basic ostream
class sentry; |
||
类 basic_ostream::sentry
的对象在 std::basic_ostream 的每个进行输出(有格式与无格式)的成员函数起始的局部作用域中构造。其构造函数准备输出流:检查流是否已在失败状态,冲入所 tie() 的输出流,并且若需要则进行其他实现定义的任务。实现定义的清理,还有若有必要的输出流冲入,在析构函数中进行,从而保证若输出中抛出异常则得到执行。
成员函数
(构造函数) |
构造 sentry 对象。所有准备任务都在此完成。 (公开成员函数) |
(析构函数) |
在有格式输入后或异常后终止化流对象,若有必要 (公开成员函数) |
operator= |
赋值运算符被删除 (公开成员函数) |
operator bool |
检查流对象的准备是否成功 (公开成员函数) |
std::basic_ostream::sentry::sentry
explicit sentry( std::basic_ostream<CharT,Traits>& os ); |
||
为有格式输出准备流。
若 os.good() 为 false 则返回。否则若 os.tie() 不是空指针,则调用 os.tie()->flush() 以令输出序列同步于外部流。在准备中,构造函数可能调用 setstate(failbit) (它可能抛出 std::ios_base::failure )。
若在准备完成后 os.good() == true ,则任何对 operator bool 的后继调用都会返回 true 。
参数
os | - | 要准备的输出流 |
异常
若文件尾条件出现则为 std::ios_base::failure。
std::basic_ostream::sentry::~sentry
~sentry(); |
||
若 (os.flags() & std::ios_base::unitbuf) && !std::uncaught_exception() && os.good()) 为 true ,则调用 os.rdbuf()->pubsync() 。若该函数返回 -1 ,则于 os.rdstate() 中设置 badbit ,而不传播异常。
std::basic_ostream::sentry::operator bool
explicit operator bool() const; |
||
检查输出流的准备是否成功。
参数
(无)
返回值
若输出流的准备成功则为 true ,否则为 false 。
示例
运行此代码
#include <iostream> #include <sstream> struct Foo { char n[6]; }; std::ostream& operator<<(std::ostream& os, Foo& f) { std::ostream::sentry s(os); if (s) { os.write(f.n, 5); } return os; } int main() { Foo f = { "abcde" }; std::cout << f << '\n'; }
输出:
abcde
参阅
插入带格式数据 (公开成员函数) |