public member function
<streambuf> <iostream>

std::streambuf::sputbackc

int sputbackc (char c);
将字符放回
尝试将受控输入序列的当前位置指示器移回当前位置之前的字符。

成员函数sungetc的行为类似,但不需要参数。

在内部,如果获取指针gptr)没有可用的后插位置,或者如果c不匹配当前获取位置之前的字符,则该函数会调用虚保护成员pbackfail。否则,该函数直接使用获取指针gptr),而不调用虚成员函数。

其行为等同于如下实现:
1
2
3
4
5
6
int sputbackc(char c) {
  if ( (!gptr()) || (gptr()==eback()) || (c!=gptr()[-1]) )
    return pbackfail(c);
  gbump(-1);
  return *gptr();
}

参数

c
要放回的字符。
如果这与后插位置的字符不匹配,则行为取决于pbackfail:它可能失败、被忽略或覆盖该位置的字符。

返回值

作为 `int` 类型的值,被后插的字符的值。
失败时,该函数返回文件尾(end-of-file)值(EOF)。

示例

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

int main () {
  char ch;
  std::streambuf * pbuf = std::cin.rdbuf();

  std::cout << "Please, enter some letters and then a number: ";
  do {
    ch = pbuf->sbumpc();

    if ( (ch>='0') && (ch <='9') )
    {
      pbuf->sputbackc (ch);
      long n;
      std::cin >> n;
      std::cout << "You entered number " << n << '\n';
      break;
    }
  } while ( ch != EOF );

  return 0;
}

此示例逐个从标准输入获取字符。当找到第一个数字时,调用sputback将流的位置恢复到该数字,以便使用提取运算符>>将其作为数字的一部分提取。

数据竞争

修改*流缓冲区*对象。
同时访问同一*流缓冲区*对象可能会导致数据竞争。

异常安全

基本保证:如果抛出异常,则流缓冲区处于有效状态(这也适用于标准派生类)。

另见