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

< cpp‎ | io‎ | basic streambuf
 
 
 
 
virtual int_type underflow();

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

函数可以更新 gptregptreback 指针,以定义新加载的数据位置(若存在)。失败时,函数确保 gptr() == nullptrgptr() == egptr

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

参数

(无)

返回值

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

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

注意

std::streambuf 的公开函数仅若 gptr() == nullptrgptr() >= 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

参阅

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