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

来自cppreference.com
< cpp‎ | io‎ | basic filebuf
 
 
 
 
protected:
virtual int_type underflow()

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

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

参数

(无)

返回值

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

示例

#include <fstream>
#include <iostream>
 
struct mybuf : std::filebuf
{
    int underflow()
    {
         std::cout << "underflow() 前:获取区大小为 "
                   << egptr()-eback() << " 并有 "
                   << egptr()-gptr() << " 个可用读取位置\n";
         int rc = std::filebuf::underflow();
         std::cout << "underflow() 返回 " << rc << ".\n调用后,"
                   << "获取区大小为 "
                   << egptr()-eback() << " 并有 "
                   << egptr()-gptr() << " 个可用读取位置\n";
        return rc;
    }
};
 
int main()
{
    mybuf buf;
    buf.open("test.txt", std::ios_base::in);
    std::istream stream(&buf);
    while(stream.get()) ;
}

可能的输出:

underflow() 前:获取区大小为 0 并有 0 个可用读取位置
underflow() 返回 73.
调用后,获取区大小为 110 并有 110 个可用读取位置
underflow() 前:获取区大小为 110 并有 0 个可用读取位置
underflow() 返回 -1.
调用后,获取区大小为 0 并有 0 个可用读取位置

参阅

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