public member function
<istream> <iostream>

std::istream::peek

int peek();
窥视下一个字符
在不提取它的情况下返回输入序列中的下一个字符:该字符保持为要从流中提取的下一个字符。

如果在调用之前已设置了任何内部状态标志,或者在调用过程中设置了,则函数返回文件结束值(EOF)。

在内部,该函数通过首先构造一个sentry对象(将noskipws设置为true)来访问输入序列。然后(如果good),它通过调用其成员函数sgetc从其关联的流缓冲区对象中读取一个字符,最后在返回之前销毁sentry对象。

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

参数



返回值

输入序列中的下一个字符,类型为int

如果没有更多字符可从输入序列中读取,或者设置了任何内部状态标志,则函数返回文件结束值(EOF),并留下正确的内部状态标志设置。

flagerror
eofbit由于输入序列中没有可用字符(已达到文件结尾),因此无法窥视字符。
failbit构造sentry失败(例如,当流状态在调用之前不是good时)。
badbit流错误(例如,当此函数捕获由内部操作抛出的异常时)。
设置时,流的完整性可能受到影响。
一次操作可能设置多个标志。

如果操作设置了一个已与成员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
25
26
27
28
29
// istream::peek example
#include <iostream>     // std::cin, std::cout
#include <string>       // std::string
#include <cctype>       // std::isdigit

int main () {

  std::cout << "Please, enter a number or a word: ";
  std::cout.flush();    // ensure output is written

  std::cin >> std::ws;  // eat up any leading white spaces
  int c = std::cin.peek();  // peek character

  if ( c == EOF ) return 1;
  if ( std::isdigit(c) )
  {
    int n;
    std::cin >> n;
    std::cout << "You entered the number: " << n << '\n';
  }
  else
  {
    std::string str;
    std::cin >> str;
    std::cout << "You entered the word: " << str << '\n';
  }

  return 0;
}

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


数据竞争

修改流对象。
对同一流对象的并发访问可能会导致数据争用,除了标准流对象cin当它与stdio同步时(在这种情况下,不会引发数据争用,尽管不对读取的字符归因于线程的顺序做任何保证)。

异常安全

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

另见