std::basic_stringbuf<CharT,Traits,Allocator>:: underflow
|
protected
:
virtual int_type underflow ( ) |
||
Считывает следующий символ из области получения буфера.
В частности:
Любой символ в буфере, который был инициализирован, независимо от того, был ли он передан в конструкторе строки или добавлен с помощью 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>
)
|