std::basic_istream<CharT,Traits>::gcount - cppreference.com (original) (raw)

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

The following member functions of basic_istream change the value of subsequent gcount() calls:

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

The following functions set gcount() 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 of std::streamsize if the number is not representable.

[edit] Example

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

Output:

[edit] Defect reports

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