std::basic_filebuf<CharT,Traits>:: 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

Смотрите также