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

 

C++

编译器支持

独立和托管式

语言

标准库

标准库头文件

具名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

输入/输出库

I/O 操纵符

打印函数 (C++23)

C 风格 I/O

缓冲区

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

流

抽象概念

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

文件 I/O

basic_ifstream

basic_ofstream

basic_fstream

字符串 I/O

basic_istringstream

basic_ostringstream

basic_stringstream

数组 I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

同步输出

basic_osyncstream (C++20)

类型

streamoff

streamsize

fpos

错误类别接口

iostream_category (C++11)

io_errc (C++11)

 

std::basic_filebuf

公共成员函数

basic_filebuf::basic_filebuf

basic_filebuf::~basic_filebuf

basic_filebuf::operator= (C++11)

basic_filebuf::swap (C++11)

basic_filebuf::native_handle (C++26)

basic_filebuf::is_open

basic_filebuf::open

basic_filebuf::close

受保护成员函数

basic_filebuf::showmanyc

basic_filebuf::underflow

basic_filebuf::uflow

basic_filebuf::pbackfail

basic_filebuf::overflow

basic_filebuf::setbuf

basic_filebuf::seekoff

basic_filebuf::seekpos

basic_filebuf::sync

basic_filebuf::imbue

非成员函数

swap(std::basic_filebuf) (C++11)

 

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 << "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

参见

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