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

Гарантирует, что по крайней мере один символ доступен во входной области, обновляя указатели на входную область (если необходимо) и считывая дополнительные данные из входной последовательности (если применимо). Возвращает значение этого символа (преобразованного в int_type с помощью Traits :: to_int_type ( c ) ) при успехе или Traits :: eof ( ) при неудаче.

Функция может обновить указатели gptr , egptr и eback для определения местоположения вновь загруженных данных (если таковые имеются). При неудаче функция гарантирует, что либо gptr ( ) == nullptr , либо gptr ( ) == egptr .

Базовая версия функции в базовом классе не выполняет никаких действий. Производные классы могут переопределить эту функцию, чтобы разрешить обновления в области получения в случае исчерпания.

Параметры

(нет)

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

Значение символа, на который указывает get pointer после успешного вызова, или Traits :: eof ( ) в противном случае.

Базовая версия функции возвращает traits :: eof ( ) .

Примечание

Публичные функции std::streambuf вызывают эту функцию только если gptr ( ) == nullptr или gptr ( ) >= egptr ( ) .

Пример

#include <iostream>
#include <sstream>
class null_filter_buf : public std::streambuf
{
    std::streambuf* src;
    char ch; // single-byte buffer
protected:
    int underflow()
    {
        traits_type::int_type i;
        while ((i = src->sbumpc()) == '\0')
            ; // skip zeroes
        if (!traits_type::eq_int_type(i, traits_type::eof()))
        {
            ch = traits_type::to_char_type(i);
            setg(&ch, &ch, &ch+1); // make one read position available
        }
        return i;
    }
public:
    null_filter_buf(std::streambuf* buf) : src(buf)
    {
        setg(&ch, &ch + 1, &ch + 1); // buffer is initially full
    }
};
void filtered_read(std::istream& in)
{
    std::streambuf* orig = in.rdbuf();
    null_filter_buf buf(orig);
    in.rdbuf(&buf);
    for (char c; in.get(c);)
        std::cout << c;
    in.rdbuf(orig);
}
int main()
{
    char a[] = "This i\0s \0an e\0\0\0xample";
    std::istringstream in(std::string(std::begin(a), std::end(a)));
    filtered_read(in);
}

This is an example

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