Namespaces
Variants
Views
Actions

std::basic_filebuf::underflow

From cppreference.com
< cpp‎ | io‎ | basic filebuf
Revision as of 20:50, 25 June 2013 by P12 (Talk | contribs)

protected:
virtual int_type underflow()

Reads more data into the input area.

Behaves like the base class std::basic_streambuf::underflow, except that to read the data from the associated character sequence (the file) into the get area, first reads the bytes from the file into a temporary buffer (allocated as large as necessary), then uses std::codecvt::in of the imbued locale to convert the external (typically, multibyte) representation to the internal form which is then used to populate the get area. The conversion may be skipped if the locale's std::codecvt::always_noconv returns true

Contents

Parameters

(none)

Return value

Traits::to_int_type(*gptr()) (the first character of the pending sequence) in case of success, or Traits::eof() in case of failure.

Example

See also

[virtual]
reads characters from the associated input sequence to the get area
(virtual protected member function of std::basic_streambuf) [edit]
[virtual]
reads from the associated file and advances the next pointer in the get area
(virtual protected member function) [edit]
[virtual]
writes characters to the associated file from the put area
(virtual protected member function) [edit]