std::basic_streambuf<CharT,Traits>::underflow
来自cppreference.com
< cpp | io | basic streambuf
protected: 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 :publicstd::streambuf{std::streambuf* src;char ch;// 单字节缓冲区protected:int underflow(){ traits_type::int_type i;while((i = src->sbumpc())=='\0');// 跳过零if(!traits_type::eq_int_type(i, traits_type::eof())){ 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 的虚受保护成员函数) |