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> 的公开成员函数)