Namespaces
Variants

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

From cppreference.net
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"); // поток для чтения-записи
    std::iostream stream(&sbuf);
    int n;
    stream >> n; // вызывает sgetc() четыре раза
                 // три вызова возвращают символы '1', '2', '3'
                 // при четвертом вызове gptr() == egptr() и вызывается underflow()
                 // underflow возвращает EOF
    std::cout << "n = " << n << '\n';
    stream.clear(); // очистить флаг eofbit
    stream << "123456"; // sputc() вызывается 6 раз
                        // первые три вызова сохраняют "123" в существующем буфере
                        // 4-й вызов обнаруживает, что pptr() == epptr() и вызывает overflow()
                        // overflow() увеличивает буфер и устанавливает egptr() в 4
                        // 5-й и 6-й вызовы сохраняют '5' и '6', продвигая pptr()
    stream >> n; // вызывает sgetc() 4 раза
                 // 1-й вызов возвращает '4', который стал доступен благодаря overflow()
                 // при 2-м вызове egptr() == egptr() и вызывается underflow()
                 // underflow продвигает egptr() до pptr() (который равен 6)
                 // 3-й sgetc() возвращает '6'
                 // 4-й sgetc() обнаруживает gptr() == egptr(), вызывает underflow()
                 // underflow() возвращает 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 Applied to Behavior as published Correct behavior
LWG 432 C++98 было неясно, считаются ли символы, добавленные overflow()
частью входной последовательности
прояснено

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

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