# std::basic_filebuf<CharT,Traits>::underflow

< cpp‎ | io‎ | basic filebuf

protected: virtual int_type underflow() |  |

读取更多数据到输入区中。

表现类似基类 std::basic_streambuf::underflow ，除了要从关联字符序列（文件）读取数据到获取区中。首先从文件读取字符到临时缓冲区（分配所需大小），然后用感染的 locale 的 std::codecvt::in 转换外部（典型为多字节）表示为之后用于填充获取区的内部形式。若该 locale 的 std::codecvt::always_noconv 返回 true 则可以跳过转换。

### 参数

（无）

### 返回值

成功情况下为 Traits::to_int_type(*gptr()) （待处理序列的首字符），失败情况下为 Traits::eof() 。

### 示例

    #include <fstream>
    #include <iostream>

    struct mybuf : std::filebuf
    {
        int underflow() {
             std::cout << "Before underflow(): size of the get area is "
                       << egptr()-eback() << " with "
                       << egptr()-gptr() << " read positions available\n";
             int rc = std::filebuf::underflow();
             std::cout << "underflow() returns " << rc << ".\nAfter the call, "
                       << "size of the get area is "
                       << egptr()-eback() << " with "
                       << egptr()-gptr() << " read positions available\n";
            return rc;
        }
    };

    int main()
    {
        mybuf buf;
        buf.open("test.txt", std::ios_base::in);
        std::istream stream(&buf);
        while(stream.get()) ;
    }

可能的输出：

    Before underflow(): size of the get area is 0 with 0 read positions available
    underflow() returns 73.
    After the call, size of the get area is 110 with 110 read positions available
    Before underflow(): size of the get area is 110 with 0 read positions available
    underflow() returns -1.
    After the call, size of the get area is 0 with 0 read positions available

### 参阅

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