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

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

命名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用实用程序库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (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 区域和当前嵌入的区域所需的任何未移位序列。

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++ 标准。

DR	应用于	发布的行为	正确行为
LWG 55	C++98	seekpos 返回未定义的 失败时返回无效的流位置	pos_type(off_type(-1)) 失败时返回
LWG 171	C++98	重新定位操作的顺序不明确	已明确

另请参见

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