std::basic_stringbuf<CharT,Traits,Allocator>::seekpos

来自cppreference.com
< cpp‎ | io‎ | basic stringbuf
 
 
 
 
protected:

virtual pos_type seekpos( pos_type sp,

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

在可能时重寻位 std::basic_streambuf::gptr 和/或 std::basic_streambuf::pptrsp 指示的位置。

等效地执行 seekoff(off_type(sp), std::ios_base::beg, which)

参数

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() 的单参数版本调用。

示例

#include <sstream>
#include <iostream>
 
struct mybuf : std::stringbuf
{
    mybuf(const std::string& str) : std::stringbuf(str) {}
 
    pos_type seekpos(pos_type sp, std::ios_base::openmode which)
    {
        std::cout << "在 seekpos(" << sp << ") 前,读取区域的大小是 "
                  << egptr() - eback() << ",其中有 "
                  << egptr() - gptr() << " 个可用读取位置。\n";
 
        pos_type rc = std::stringbuf::seekpos(sp, which);
 
        std::cout << "seekpos() 返回 " << rc << "。\n在调用后,"
                  << "读取区域的大小是 "
                  << egptr() - eback() << ",其中有 "
                  << egptr() - gptr() << " 个可用读取位置。\n";
 
        return rc;
    }
};
 
int main()
{
    mybuf buf("12345");
    std::iostream stream(&buf);
    stream.seekg(2);
}

输出:

在 seekpos(2) 前,读取区域的大小是 5,其中有 5 个可用读取位置。
seekpos() 返回 2。
在调用后,读取区域的大小是 5,其中有 3 个可用读取位置。

缺陷报告

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

缺陷报告 应用于 出版时的行为 正确行为
LWG 375 C++98 std::ios_base 的静态常量成员被误指定为 std::basic_ios 的成员 已修正
LWG 564 C++98 不明确如何重寻位 gptr 和/或 pptr 通过 seekoff() 重寻位

参阅

调用 seekpos()
(std::basic_streambuf<CharT,Traits> 的公开成员函数)
用相对寻址,重定位输入序列、输出序列或两者中的下一位置指针
(虚受保护成员函数)
用绝对寻址重寻位文件位置
(std::basic_filebuf<CharT,Traits> 的虚受保护成员函数)
用绝对寻址重寻位输入序列、输出序列或两者中的下一位置指针
(std::strstreambuf 的虚受保护成员函数)