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

< cpp‎ | io‎ | basic streambuf

virtual int_type underflow(); |  |

通过更新指向输入区的指针（若需要），和从输入序列读取更多数据（若可用），确保输入区中至少一个字符可用。成功时返回该字符的值（以 `int_type` 转换为 Traits::to_int_type(c) ），失败时返回 Traits::eof() 。

函数可以更新 `gptr` 、 `egptr` 和 `eback` 指针，以定义新加载的数据位置（若存在）。失败时，函数确保 gptr() == nullptr 或 gptr() == egptr 。

函数的基类版本不做任何事。导出类可覆写此函数以允许在耗尽情况下更新获取区。

### 参数

（无）

### 返回值

成功时为调用后获取指针所指向的字符的值。否则为 Traits::eof() 。

函数的基类版本返回 traits::eof() 。

### 注意

std::streambuf 的公开函数仅若 gptr() == nullptr 或 gptr() >= egptr() 才调用此函数。

### 示例

    #include <iostream>
    #include <sstream>

    class null_filter_buf : public std::streambuf {
        std::streambuf* src;
        char ch; // 单字节缓冲区
    protected:
        int underflow() {
            traits_type::int_type i;
            while ((i = src->sbumpc()) == '\0') ; // 跳过零
            if (traits_type::not_eof(i)) {
                ch = traits_type::to_char_type(i);
                setg(&ch, &ch, &ch+1); // 使得一个读取位置可用
            }
            return i;
        }
    public:
        null_filter_buf(std::streambuf* buf) : src(buf) {
            setg(&ch, &ch+1, &ch+1); // 缓冲区初始为满
        }
    };

    void filtered_read(std::istream& in)
    {
        std::streambuf* orig = in.rdbuf();
        null_filter_buf buf(orig);
        in.rdbuf(&buf);
        for(char c; in.get(c); )
                std::cout << c;
        in.rdbuf(orig);
    }

    int main()
    {
        char a[] = "This i\0s \0an e\0\0\0xample";
        std::istringstream in(std::string(std::begin(a), std::end(a)));
        filtered_read(in);
    }

输出：

    This is an example

### 参阅

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