public member function
<streambuf> <iostream>

std::basic_streambuf::sungetc

int_type sungetc();
回退当前位置
尝试将*受控输入序列*的当前位置指示器向后移动一个位置到其前一个字符,使该位置的字符再次可用于下一个输入操作。

在内部,如果在调用函数时*获取指针*(gptr)指向*缓冲区起始*(eback)时,函数会调用虚保护成员函数 pbackfail。否则,函数直接使用*获取指针*(gptr),而不调用任何虚成员函数。

其行为等同于如下实现:
1
2
3
4
5
int_type sungetc() {
  if ( (!gptr()) || (gptr()==eback()) ) return pbackfail();
  gbump(-1);
  return traits_type::to_int_type(*gptr());
}

参数



返回值

作为*受控输入序列*的新当前字符的值,使用成员 traits_type::to_int_type 转换为 int_type 类型的值。
如果失败,该函数返回*文件结束符*值(traits_type::eof())。
成员类型int_type是能够表示任何字符值或特殊*文件结束*符的整型。

示例

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

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->sungetc ();
      long n;
      std::cin >> n;
      std::cout << "You entered number " << n << '\n';
      break;
    }
  } while ( ch != std::streambuf::traits_type::eof() );

  return 0;
}

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

数据竞争

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

异常安全

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

另见