std::basic_istream<CharT,Traits>::sentry
| class sentry; |
||
basic_istream::sentry 类的对象在每个执行输入（格式化和非格式化）的 std::basic_istream 成员函数的开头在局部范围内构造。它的构造函数准备输入流：检查流是否已处于失败状态，刷新绑定的输出流，跳过前导空白，除非设置了 noskipws 标志，并在必要时执行其他实现定义的任务。如果必要，所有清理都在析构函数中执行，因此保证在输入过程中抛出异常时会发生清理。
内容 |
[编辑] 成员类型
traits_type
|
Traits
|
[编辑] 成员函数
| (构造函数) |
构造 sentry 对象。所有准备工作都在这里完成 (公共成员函数) |
| (析构函数) |
在格式化输入或异常后，如果需要，完成流对象 (公共成员函数) |
| operator= [已删除] |
不可复制赋值 (公共成员函数) |
| operator bool |
检查流对象的准备是否成功 (公共成员函数) |
std::basic_istream::sentry::sentry
| explicit sentry( std::basic_istream<CharT, Traits>& is, bool noskipws = false ); |
||
为格式化输入准备流。
如果 is.good() 为 false，则调用 is.setstate(std::ios_base::failbit) 并返回。否则，如果 is.tie() 不是空指针，则调用 is.tie()->flush() 以将输出序列与外部流同步。如果 is.tie() 的输出区为空，则可以抑制此调用。实现可能会将对 flush() 的调用推迟到调用 is.rdbuf()->underflow() 时。如果在销毁 sentry 对象之前没有发生此类调用，则可以完全消除它。
如果 noskipws 为零，并且 is.flags() & std::ios_base::skipws 不为零，则该函数提取并丢弃所有空白字符，直到下一个可用字符不是空白字符（由 is 中当前注入的区域设置确定）。如果 is.rdbuf()->sbumpc() 或 is.rdbuf()->sgetc() 返回 traits::eof()，则该函数调用 setstate(std::ios_base::failbit | std::ios_base::eofbit)（这可能会抛出 std::ios_base::failure）。
可能会发生其他实现定义的准备工作，这可能会调用 setstate(std::ios_base::failbit)（这可能会抛出 std::ios_base::failure）。
如果在完成准备工作后，is.good() == true，则对 operator bool 的任何后续调用都将返回 true。
参数
| is | - | 要准备的输入流 |
| noskipws | - | 如果不应该跳过空白，则为 true |
异常
如果在跳过空白时发生文件结束条件，则为 std::ios_base::failure。
std::basic_istream::sentry::~sentry
| ~sentry(); |
||
不执行任何操作。
std::basic_istream::sentry::operator bool
| explicit operator bool() const; |
||
检查输入流的准备是否成功。
参数
(无)
返回值
如果输入流的初始化成功，则为 true，否则为 false。
[编辑] 示例
#include <iostream> #include <sstream> struct Foo { char n[5]; }; std::istream& operator>>(std::istream& is, Foo& f) { std::istream::sentry s(is); if (s) is.read(f.n, 5); return is; } int main() { std::string input = " abcde"; std::istringstream stream(input); Foo f; stream >> f; std::cout.write(f.n, 5); std::cout << '\n'; }
输出
abcde
[编辑] 缺陷报告
以下更改行为的缺陷报告已追溯应用于以前发布的 C++ 标准。
| DR | 应用于 | 发布的行为 | 正确的行为 |
|---|---|---|---|
| LWG 195 | C++98 | 不清楚构造函数是否会设置eofbit |
已经明确 |
| LWG 419 | C++98 | 如果eofbit已被设置，构造函数不会设置failbit |
在这种情况下会设置failbit |
[编辑] 另见
| 提取格式化数据 (公共成员函数) | |
| 提取字符和字符数组 (函数模板) |
