public member function
<istream>
streamsize gcount ( ) const;
Get number of characters extracted by last unformatted input operation
Returns the number of characters extracted by the last unformatted input operation performed on the object.
The unformatted input operations that modify the value returned by this function are those performed by the following member functions:
get,
getline,
ignore,
peek,
read,
readsome,
putback and
unget.
Notice though, that
peek,
putback and
unget do not extract characters. So
gcount will always return zero after a call to any of these.
Parameters
none
Return Value
An integer value of type
streamsize with the number of characters extracted by the last unformatted input operation.
Basic template member declaration
( basic_istream<charT,traits> )
|
streamsize gcount () const;
|
See also
- istream::get
- Get unformatted data from stream (public member function)
- istream::getline
- Get line from stream (public member function)
- istream::ignore
- Extract and discard characters (public member function)
- istream::read
- Read block of data (public member function)
- istream::readsome
- Read block of data available in the buffer (public member function)