# 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

### 参阅

underflow [虚] | 从关联输入序列读取字符到获取区 (`std::basic_streambuf<CharT,Traits>` 的虚受保护成员函数)
underflow [虚] | 从关联文件读取 (`std::basic_filebuf<CharT,Traits>` 的虚受保护成员函数)
underflow [虚] | 从输入序列读取一个字符而不前进下一位置指针 (`std::strstreambuf` 的虚受保护成员函数)
sgetc | 从输入序列读取一个字符，而不令序列前进 (`std::basic_streambuf<CharT,Traits>` 的公开成员函数)