C++ 命名要求： UnformattedInputFunction
来自 cppreference.cn
[编辑] 要求
UnformattedInputFunction 是执行以下操作的流输入函数
1) 构造一个具有自动存储持续时间且
noskipws 参数设置为 true 的 basic_istream::sentry 类型的对象，该对象执行以下操作- 如果输入流上设置了 eofbit 或 badbit，则也设置 failbit，并且如果在此输入流的 异常掩码 中启用了
failbit上的异常 ((exceptions() & failbit) != 0)，则抛出 ios_base::failure。 - 刷新 tie()'d 输出流（如果适用）。
2) 通过调用
sentry::operator bool() 检查 sentry 的状态，这等效于 basic_ios::good。- 如果运算符返回 false 或 sentry 的构造函数抛出异常
- 将输入流中提取的字符数 (gcount) 设置为零。
- 如果调用该函数是为了写入
CharT数组，则将CharT()(空字符) 写入数组的第一个位置。
- 如果运算符返回 true，则执行输入，就像通过调用 rdbuf()->sbumpc() 或 rdbuf()->sgetc() 一样。
- 如果到达流的末尾（调用 rdbuf()->sbumpc() 或 rdbuf()->sgetc() 返回 Traits::eof())，则设置
eofbit。 如果在此流的 异常掩码 中启用了eofbit上的异常 ((exceptions() & eofbit) != 0)，则抛出 ios_base::failure。 - 如果在输入期间抛出异常，则在输入流中设置
badbit。 如果在此流的 异常掩码 中启用了badbit上的异常 ((exceptions() & badbit) != 0)，则也会重新抛出该异常。
- 从 basic_ios::clear 抛出的异常不会被捕获或重新抛出。
- 如果在输入期间未抛出异常，则设置输入流中提取的字符数 (gcount)。
- 如果到达流的末尾（调用 rdbuf()->sbumpc() 或 rdbuf()->sgetc() 返回 Traits::eof())，则设置
3) 在任何情况下，无论是因异常终止还是返回，sentry 的析构函数都会在本函数退出之前被调用。
[编辑] 标准库
以下标准库函数是 UnformattedInputFunction。
- std::getline，但它不修改 gcount。
- basic_istream::operator>>(basic_streambuf*)
- basic_istream::get
- basic_istream::getline
- basic_istream::ignore
- basic_istream::peek
- basic_istream::read
- basic_istream::readsome
- basic_istream::putback，但它首先清除
eofbit - basic_istream::unget，但它首先清除
eofbit - basic_istream::sync，但它不修改 gcount
- basic_istream::tellg，但它不修改 gcount
- basic_istream::seekg，但它首先清除
eofbit且不修改 gcount - std::ws，但它不修改 gcount
[编辑] 缺陷报告
以下行为更改缺陷报告被追溯应用于先前发布的 C++ 标准。
| DR | 应用于 | 已发布行为 | 正确行为 |
|---|---|---|---|
| LWG 61 | C++98 | 不清楚是否由于以下原因抛出异常 设置 eofbit 和/或 failbit 将导致设置 badbit |
从 basic_ios::clear 抛出的异常 不会被捕获或重新抛出 |
| LWG 160 | C++98 | 确定捕获的异常是否被重新抛出的过程 提到了一个不存在的函数 exception() |
更正为 exceptions() |
| LWG 243 | C++98 | 当 sentry::operator bool() 返回 false 时的行为或者未指定 sentry 对象构造失败的情况 |
已指定 |
