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

< cpp‎ | io‎ | basic filebuf
 
C++
 
输入/输出库
 
std::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

参阅

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