public member function
<istream> <iostream>

std::basic_istream::putback

basic_istream& putback (char_type c);
将字符放回
尝试将流的当前位置减少一个字符,使从流中提取的最后一个字符再次可供提取操作使用。

该函数在内部通过构造一个sentry对象(将noskipws设置为true)来访问输入序列。然后(如果good),它会对其关联的流缓冲区对象(如果存在)调用sputbackc(c)。最后,它会销毁sentry对象并返回。

如果在调用之前设置了 eofbit 标志,则函数失败(设置 failbit 并返回)。
该函数会清除在调用之前设置的 eofbit 标志。

如果对sputbackc的调用失败,该函数会将badbit标志设置为true。请注意,即使c确实是从流中提取的最后一个字符,也可能发生这种情况(具体取决于关联的流缓冲区对象的内部实现)。

调用此函数会将 gcount 的返回值设置为零。

参数

c
要放回的字符。
如果这与回放位置的字符不匹配,则行为取决于与流关联的特定流缓冲区对象
  • 字符串缓冲区中,对于输出流缓冲区,该值会被覆盖,但函数在输入缓冲区上失败。
其他类型的流缓冲区可能会失败、被忽略或覆盖该位置的字符。
成员类型 char_type 是流使用的字符类型(即其第一个类模板参数 charT)。

返回值

*thisbasic_istream 对象。

错误通过修改内部状态标志来发出信号
flagerror
eofbit-
failbit构造 sentry 失败(例如,当调用前的 *流状态* 不是 good 时)。
badbit要么是内部调用sputbackc失败,要么是流上发生了其他错误(例如,当函数捕获内部操作抛出的异常时,或者当流没有关联流缓冲区时)。
当设置时,流的完整性可能受到影响。
单个操作可以设置多个标志。

如果操作设置了一个已通过成员exceptions注册的内部状态标志,则该函数将抛出成员类型为failure的异常。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
// istream::putback example
#include <iostream>     // std::cin, std::cout
#include <string>       // std::string

int main () {
  std::cout << "Please, enter a number or a word: ";
  char c = std::cin.get();

  if ( (c >= '0') && (c <= '9') )
  {
    int n;
    std::cin.putback (c);
    std::cin >> n;
    std::cout << "You entered a number: " << n << '\n';
  }
  else
  {
    std::string str;
    std::cin.putback (c);
    getline (std::cin,str);
    std::cout << "You entered a word: " << str << '\n';
  }
  return 0;
}

可能的输出
Please, enter a number or a word: pocket
You entered a word: pocket


数据竞争

修改流对象。
并发访问同一个流对象可能导致数据争用。

异常安全

基本保证:如果抛出异常,对象处于有效状态。
如果结果错误状态标志不是goodbit且成员exceptions被设置为针对该状态抛出,则抛出成员类型为failure的异常。
任何由内部操作抛出的异常都会被函数捕获并处理,将badbit设置为true。如果badbit在上次调用exceptions时被设置,则函数将重新抛出捕获到的异常。

另见