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

 

C++

编译器支持

自由（freestanding）与宿主（hosted）

语言

标准库

标准库头文件

具名要求

特性测试宏 (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 pos_type seekpos( pos_type sp,                           std::ios_base::openmode which = std::ios_base::in | std::ios_base::out );

如果可能，将文件指针重新定位到 sp 指示的位置。如果关联文件未打开 (is_open() == false)，则立即失败。

重新定位执行如下：

1) 如果文件已打开用于写入，则使用 overflow() 写入 put 区域和当前区域设置所需的任何 unshift 序列。

2) 重新定位文件指针，如同调用 std::fsetpos()。

3) 如果文件已打开用于读取，则在必要时更新 get 区域。

如果 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() 中更新 get 区域，而是委托给由下一个 sgetc() 调用的 underflow()。

示例

在某些实现中，get 区域由 seekpos() 清空，第二次 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";
// uncomment if get area is emptied by 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(); // read one char to force underflow()
    stream.seekg(2);
}

可能的输出

Before seekpos(2), size of the get area is 110 with 109 read positions available.
seekpos() returns 2.
After the call, size of the get area is 110 with 108 read positions available.

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告	应用于	发布时的行为	正确的行为
LWG 55	C++98	seekpos 返回一个未定义值 的非法流位置	pos_type(off_type(-1)) 在失败时返回
LWG 171	C++98	重新定位操作的顺序不明确	已明确

另请参阅

pubseekpos	调用 seekpos() (std::basic_streambuf<CharT,Traits> 的公共成员函数)
seekoff [虚函数]	使用相对地址重新定位文件位置 (虚保护成员函数)
fseek	将文件位置指示器移动到文件中特定位置 (函数)