std::basic_stringbuf<CharT,Traits,Allocator>::underflow
< 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> 的公开成员函数) |