| streambuf::showmanyc | virtual protected member function |
int 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
noneReturn 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.Basic template member declaration
( basic_streambuf<charT,traits> )
int 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 (virtual protected member function) |