Returns the number of characters extracted by the lastunformatted input operation, or the maximum representable value ofstd::streamsize if the number is not representable.

The following member functions ofbasic_istream change the value of subsequentgcount() calls:

• move constructor
• swap()
• get()
• getline()
• ignore()
• read()
• readsome()
• operator>>(basic_streambuf*)

The following functions setgcount() to zero:

• constructor
• putback()
• unget()
• peek()

[edit]Parameters

(none)

[edit]Return value

The number of characters extracted by the last unformatted input operation, or the maximum representable value ofstd::streamsize if the number is not representable.

[edit]Example

#include <iostream>#include <sstream> int main(){char x[20];std::istringstream stream("Hello World");     stream.read(x, sizeof x);std::cout<<"Characters extracted: "<< stream.gcount();}

Characters extracted: 11

[edit]Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

• In other languages

• Deutsch
• Español
• Français
• Italiano
• 日本語
• Português
• Русский
• 中文