public member function
<istream> <iostream>

std::basic_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 characteres read: simplify


資料競爭

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

異常安全

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

另見