protected virtual member function
<streambuf>
streamsize showmanyc ( );
Get number of characters available in the sequence
This member function (to be read s-how-many-c) is called to get an estimate on the number of characters available in the associated input sequence when the
get pointer has reached the apparent end of the associated sequence (still, characters may be available after an
underflow, and their count is what the return value of this function is expected to be).
The public member function
in_avail calls this protected member function to perform this action when the
get pointer has reached the
end pointer (or when it is set to null).
This is a virtual member function that can be redefined for a specific behavior in derived classes. Its default behavior in
streambuf is to do nothing and return a value of zero.
The standard derived class
filebuf overrides this member function (see
filebuf::showmanyc).
Parameters
none
Return Value
An estimate on the number of characters remaining to be read in the associated character sequence after an
underflow when no read positions are available at the
get pointer.
This is a value of type
streamsize.
Basic template member declaration
( basic_streambuf<charT,traits> )
|
streamsize showmanyc ( );
|
See also
- streambuf::in_avail
- Get number of characters available to read (public member function)
- streambuf::underflow
- Get character in the case of underflow (protected virtual member function)