c++11 标准模板（STL）（std::basic_filebuf）（八）

news2024/12/30 2:25:53

定义于头文件 <fstream>

template<

class CharT,
class Traits = std::char_traits<CharT>

> class basic_filebuf : public std::basic_streambuf<CharT, Traits>

std::basic_filebuf 是关联字符序列为文件的 std::basic_streambuf 。输入序列和输出序列都关联到同一文件，并为两种操作维护连接文件位置。

函数 underflow() 和 overflow()/sync() 进行文件和缓冲区的获取放置区之间的实际 I/O 。 CharT 不是 char 时，多数实现在文件存储多字节字符，并用 std::codecvt 平面进行宽/多字节字符转换。

亦为常用字符类型定义二个特化：

类型	定义
`filebuf`	basic_filebuf<char>
`wfilebuf`	basic_filebuf<wchar_t>

受保护成员函数

用绝对寻址重寻位文件位置

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

protected:

virtual pos_type seekpos( pos_type sp,

std::ios_base::openmode which = std::ios_base::in | std::ios_base::out );

若可能，则重寻位文件指针到 sp 所指示的位置。

若关联文件未打开（ is_open()==false ），则立即失败。

若文件为写入打开，则首先用 overflow() 写入放置区和任何当前感染的 locale 所要求的反迁移序列。

然后如同通过调用 std::fsetpos() 重寻位指针。

若文件为读取打开，则若需要则更新获取区。

若 sp 不是由在同一文件上调用 seekoff() 或 seekpos() 获得，则行为未定义。

参数

sp - 之前在同一文件上调用 seekoff() 或 seekpos() 获得的文件位置

which

确定要影响输入和/或输出序列的哪个。它能为下列常量之一或其组合：

常量	解释
in	影响输入序列
out	影响输出序列

返回值

成功时为 sp ，失败时为 pos_type(off_type(-1)) 。

注意

seekpos() 为 std::basic_streambuf::pubseekpos() 所调用，后者为 std::basic_istream::seekg() 和 std::basic_ostream::seekp() 的单参数版本调用。

许多实现不于 seekpos() 中更新获取区，而是委托给下次 sgetc() 所调用的 underflow() 。

调用示例

#include <fstream>
#include <iostream>

struct mybuf : std::filebuf
{
    pos_type seekpos(pos_type sp, std::ios_base::openmode which)
    {
        std::cout << "Before seekpos(" << sp << "), size of the get area is "
                  << egptr() - eback() << " with "
                  << egptr() - gptr() << " read positions available\n";
        pos_type rc = std::filebuf::seekpos(sp, which);
        std::cout << "seekpos() returns " << rc << ".\nAfter the call, "
                  << "size of the get area is "
                  << egptr() - eback() << " with "
                  << egptr() - gptr() << " read positions available\n";
// 若 seekpos() 清空获取区则反注释
//         std::filebuf::underflow();
//         std::cout << "after forced underflow(), 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);
    stream.get(); // 读一个字符以强制 underflow()
    stream.seekg(2);
}