std::basic_filebuf<CharT,Traits>::underflow

protected:
virtual int_type underflow()

Считывает больше данных в область ввода.

Ведёт себя как базовый класс std::basic_streambuf::underflow, за исключением того, что для считывания данных из связанной последовательности символов (файла) в область получения, сначала считывает байты из файла в временный буфер (выделяется столько, сколько необходимо), затем использует std::codecvt::in встроенной локали для преобразования внешнего (как правило, многобайтового) представления во внутренний вид, который затем используется для заполнения области получения. Преобразование может быть пропущено, если std::codecvt::always_noconv локали возвращает true.

Параметры

(нет)

Возвращаемое значение

Traits::to_int_type(*gptr()) (первый символ ожидаемой последовательности) в случае успеха или Traits::eof() в случае неудачи.

Пример

#include <fstream>
#include <iostream>
 
struct mybuf : std::filebuf
{
    int underflow()
    {
         std::cout << "Before underflow(): size of the get area is "
                   << egptr()-eback() << " with "
                   << egptr()-gptr() << " read positions available\n";
         int rc = std::filebuf::underflow();
         std::cout << "underflow() returns " << rc << ".\nAfter the call, "
                   << "size of the get area is "
                   << egptr()-eback() << " with "
                   << egptr()-gptr() << " read positions available\n";
        return rc;
    }
};
 
int main()
{
    mybuf buf;
    buf.open("test.txt", std::ios_base::in);
    std::istream stream(&buf);
    while (stream.get()) ;
}

Before underflow(): size of the get area is 0 with 0 read positions available
underflow() returns 73.
After the call, size of the get area is 110 with 110 read positions available
Before underflow(): size of the get area is 110 with 0 read positions available
underflow() returns -1.
After the call, size of the get area is 0 with 0 read positions available

См. также