std::basic_stringbuf<CharT,Traits,Allocator>::underflow

protected:
virtual int_type underflow()

Считывает следующий символ из области чтения буфера.

В частности:

1) Если в последовательности ввода доступна позиция чтения (egptr() > gptr()), возвращает Traits::to_int_type(*gptr())

2) В противном случае, если pptr() > egptr() (с момента последнего изменения overflow() в поток были вставлены символы, изменив egptr()), расширяет конец области чтения, включая в неё недавно вставленные символы, изменяя egptr() так, чтобы оно стало равно pptr(), а затем возвращает Traits::to_int_type(*gptr())

3) В противном случае возвращает Traits::eof().

Любой инициализированный символ в буфере считается частью последовательности ввода независимо от того, был ли он передан в строке конструктору или добавлен с помощью overflow().

Параметры

(нет)

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

Traits::to_int_type(*gptr()) (следующий символ для чтения в области чтения) в случае успеха или Traits::eof() в случае неудачи.

Пример

#include <iostream>
#include <sstream>

struct mybuf : std::stringbuf
{
    mybuf(const std::string& new_str,
          std::ios_base::openmode which = std::ios_base::in | std::ios_base::out)
        : std::stringbuf(new_str, which) {}

    int_type overflow(int_type c)
    {
        std::cout << "Before overflow():  get area size is " << egptr() - eback()
                  << ", the put area size is " << epptr() - pbase() << '\n';
        int_type rc = std::stringbuf::overflow(c);
        std::cout << "After overflow():   get area size is " << egptr() - eback()
                  << ", put area size is " << epptr() - pbase() << '\n';
        return rc;
    }

    int_type underflow()
    {
        std::cout << "Before underflow(): get area size is " << egptr() - eback()
                  << ", put area size is " << epptr() - pbase() << '\n';
        int_type ch = std::stringbuf::underflow();
        std::cout << "After underflow():  get area size is " << egptr() - eback()
                  << ", put area size is " << epptr() - pbase() << '\n';

        if (ch == EOF)
            std::cout << "underflow() returns EOF\n";
        else
            std::cout << "underflow() returns '" << char(ch) << "'\n";
        return ch;
    }
};

int main()
{
    mybuf sbuf("123"); // read-write stream
    std::iostream stream(&sbuf);
    int n;
    stream >> n; // calls sgetc() four times
                 // three calls return the characters '1', '2', '3'
                 // the fourth call, gptr() == egptr() and underflow() is called
                 // underflow returns EOF
    std::cout << "n = " << n << '\n';
    stream.clear(); // clear the eofbit

    stream << "123456"; // sputc() is called 6 times
                        // first three calls store "123" in the existing buffer
                        // 4th call finds that pptr() == epptr() and calls overflow()
                        // overflow() grows the buffer and sets egptr() to 4
                        // 5th and 6th calls store '5' and '6', advancing pptr()

    stream >> n; // calls sgetc() 4 times
                 // 1st call returns the '4' that was made available by overflow()
                 // on the 2nd call, egptr() == egptr() and underflow() is called
                 // underflow advances egptr() to equal pptr() (which is 6)
                 // 3rd sgetc() returns '6'
                 // 4th sgetc() finds gptr() == egptr(), calls underflow()
                 // underflow() returns EOF

    std::cout << "n = " << n << '\n';
}

Возможный вывод:

Before underflow(): get area size is 3, put area size is 15
After underflow():  get area size is 3, put area size is 15
underflow() returns EOF
n = 123
Before underflow(): get area size is 3, put area size is 15
After underflow():  get area size is 6, put area size is 15
underflow() returns '4'
Before underflow(): get area size is 6, put area size is 15
After underflow():  get area size is 6, put area size is 15
underflow() returns EOF
n = 456

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющих поведение, были применены задним числом к ранее опубликованным стандартам C++.

DR	Применяется к	Поведение согласно опубликованной версии	Корректное поведение
LWG 432	C++98	не было ясно, считаются ли символы, добавленные с помощью `overflow()` частью последовательности ввода	уточнено

См. также

underflow [virtual]	считывает символы из связанной последовательности ввода в область чтения (виртуальная защищённая функция-член `std::basic_streambuf<CharT,Traits>`)
underflow [virtual]	считывает данные из связанного файла (виртуальная защищённая функция-член `std::basic_filebuf<CharT,Traits>`)
underflow [virtual]	считывает символ из последовательности ввода, не перемещая следующий указатель (виртуальная защищённая функция-член `std::strstreambuf`)
sgetc	считывает один символ из последовательности ввода, не продвигая последовательность (общедоступная функция-член `std::basic_streambuf<CharT,Traits>`)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/io/basic_stringbuf/underflow