std::basic_stringbuf<CharT,Traits,Allocator>::underflow
来自cppreference.com
< cpp | io | basic stringbuf
| protected: virtual int_type underflow() |
||
从缓冲的获取区读取下个字符。
具体而言：
1) 若输入序列拥有可用的读位置（ egptr() > gptr() ），则返回 Traits::to_int_type(*gptr()) 。
2) 否则，若 pptr() > egptr() （从上次更改 egptr() 的 overflow() 起插入了一些字符到流中），则通过更改 egptr() 为等于 pptr() ，扩展获取区结尾以包含最近插入的字符，再返回 Traits::to_int_type(*gptr()) 。
3) 否则，返回 Traits::eof() 。
缓冲区中任何已被初始化的字符，无关乎它源自构造函数中传递的字符串还是为 overflow() 所后附，都被认为是输入序列的一部分。
参数
（无）
返回值
成功情况下为 Traits::to_int_type(*gptr()) （获取区中要读取的下个字符），失败情况下为 Traits::eof() 。
示例
运行此代码
#include <sstream> #include <iostream> 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'; 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 次调用返回 overflow() 使之可用的 '4' // 第 2 次调用时， egptr() == egptr() 并调用 underflow() // underflow 令 egptr() 前进到等于 pptr() (which is 6) // 第 3 次 sgetc() 返回 '6' // 第 4 次 sgetc() 发现 gptr() == egptr() ，调用 underflow() // underflow() 返回 EOF std::cout << n << '\n'; }
可能的输出：
Before underflow(): get area size is 3 put area size is 3 After underflow(): get area size is 3 put area size is 3 underflow() returns EOF 123 Before overflow(): get area size is 3 the put area size is 3 After overflow(): get area size is 4 put area size is 35 Before underflow(): get area size is 4 put area size is 35 After underflow(): get area size is 6 put area size is 35 underflow() returns '5' Before underflow(): get area size is 6 put area size is 35 After underflow(): get area size is 6 put area size is 35 underflow() returns EOF 456
参阅
| [虚] |
从关联输入序列读取字符到获取区 ( std::basic_streambuf<CharT,Traits> 的虚受保护成员函数) |
| [虚] |
从关联文件读取 ( std::basic_filebuf<CharT,Traits> 的虚受保护成员函数) |
| [虚] |
从输入序列读取一个字符而不前进下一位置指针 ( std::strstreambuf 的虚受保护成员函数) |
| 从输入序列读取一个字符，而不令序列前进 ( std::basic_streambuf<CharT,Traits> 的公开成员函数) |