public member function
<istream> <iostream>

std::istream::gcount

streamsize gcount() const;
獲取字元計數
返回對該物件執行的最後一次 *未格式化輸入操作* 所提取的字元數。

修改此函式返回值的 *未格式化輸入操作* 包括:getgetlineignorepeekreadreadsomeputbackunget

請注意,peekputbackunget 實際上不會提取任何字元,因此呼叫其中任何一個後 gcount 始終返回零。

引數



返回值

最後一次未格式化輸入操作提取的字元數。
streamsize 是一個帶符號整型。

示例

1
2
3
4
5
6
7
8
9
10
11
12
// cin.gcount example
#include <iostream>     // std::cin, std::cout

int main () {
  char str[20];

  std::cout << "Please, enter a word: ";
  std::cin.getline(str,20);
  std::cout << std::cin.gcount() << " characters read: " << str << '\n';

  return 0;
}

可能的輸出
Please, enter a word: simplify
9 characters read: simplify


資料競爭

訪問流物件。
併發訪問同一個流物件可能導致資料爭用。

異常安全

強保證: 如果丟擲異常,流不會發生任何改變。

另見