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

protected:
virtual int_type underflow();

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

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

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

Параметры

(нет)

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

Значение символа, на который указывает указатель получения после вызова при успехе или 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

См. также