Namespaces
Variants

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

From cppreference.net
C++
Input/output library
std::basic_stringbuf
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() 六次
                        // 前三次调用在现有缓冲区中存储 "123"
                        // 第四次调用发现 pptr() == epptr() 并调用 overflow()
                        // overflow() 扩展缓冲区并将 egptr() 设为 4
                        // 第五次和第六次调用存储 '5' 和 '6'，推进 pptr()
    stream >> n; // 调用 sgetc() 四次
                 // 第一次调用返回由 overflow() 提供的 '4'
                 // 第二次调用时，egptr() == egptr() 并调用 underflow()
                 // underflow 将 egptr() 推进至等于 pptr()（即 6）
                 // 第三次 sgetc() 返回 '6'
                 // 第四次 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++标准。

缺陷报告 适用范围 发布时行为 正确行为
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> 的公开成员函数)