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

参阅

插入带格式数据
(公开成员函数)