std::strstreambuf::seekoff

来自cppreference.com
< cpp‎ | io‎ | strstreambuf
 
C++
 
输入/输出库
 
std::strstreambuf
 
protected:

virtual pos_type seekoff(off_type off,
                         ios_base::seekdir way,

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

若可能，则重寻位 std::basic_streambuf::gptr 和/或 std::basic_streambuf::pptr 到对应距缓冲的获取和/或放置区起始、结尾或当前位置准确 off 个字符的位置。

  • 若 which 包含 ios_base::in 而此缓冲为读取打开，则以后述方式重寻位获取区内的读指针 std::basic_streambuf::gptr
  • 若 which 包含 ios_base::out 而此缓冲为写入打开，则以后述方式重定位放置区内的写指针 std::basic_streambuf::pptr
  • 若 which 包含 ios_base::in 和 ios_base::out 两者，而缓冲为读取和写入两者打开，且 when 为 ios_base::beg 或 ios_base::end ，则以后述方式重寻位读和写指针。
  • 否则，此函数失败。

若要重寻位指针（ gptr 或 pptr 或两者），则按下列方式进行：

1) 若要重寻位的指针为空指针，而新偏移 newoff 会为非零，则此函数失败。
2) 确定 off_type 类型的新指针偏移 newoff
a) 若 way == ios_base::beg ，则 newoff 为零
b) 若 way == ios_base::cur ，则 newoff 为指针的当前位置（ gptr()-eback() 或 pptr()-pbase() ）
c) 若 way == ios_base::end ，则 newoff 是缓冲区的整个已初始化部分长度（若使用过分配，则为高水位指针减起始指针）
3) 若 newoff + off 为负或在缓冲区的已初始化部分外，则函数失败
4) 否则，如同用 gptr() = eback() + newoff + off 或 pptr() = pbase() + newoff + off 赋值指针。

参数

off - 设置（两个）下一位置指针到的相对位置
way - 定义要应用相对偏移到的基位置。它能为下列常量之一：
常量 解释
beg 流的开始
end 流的结尾
cur 流位置指示器的当前位置
which - 定义影响输入序列、输出序列或两者。它能为下列常量之一或其组合：
常量 解释
in 影响输入序列
out 影响输出序列

返回值

成功时为 pos_type(newoff) ，失败时或若 pos_type 无法表示结果流位置则为 pos_type(off_type(-1)) 。

示例

运行此代码
#include <iostream>
#include <strstream>
 
int main()
{
    char a[] = "123";
    std::strstream ss(a, sizeof a); // in/out
    std::cout << "put pos = " << ss.tellp()
              << " get pos = " << ss.tellg() << '\n';
 
    // 绝对寻位两者的指针
    ss.rdbuf()->pubseekoff(1, std::ios_base::beg); // 前移两者
    std::cout << "put pos = " << ss.tellp()
              << " get pos = " << ss.tellg() << '\n';
 
    // 尝试从当前位置前移二个指针 1 字符
    if(-1 == ss.rdbuf()->pubseekoff(1, std::ios_base::cur))
        std::cout << "moving both pointers from current position failed\n";
    std::cout << "put pos = " << ss.tellp()
              << " get pos = " << ss.tellg() << '\n';
 
    // 前移写指针 1 字符，但不移动读指针
    // can also be called as ss.seekp(1, std::ios_base::cur);
    ss.rdbuf()->pubseekoff(1, std::ios_base::cur, std::ios_base::out);
    std::cout << "put pos = " << ss.tellp()
              << " get pos = " << ss.tellg() << '\n';
 
    ss << 'a'; // 写入放置位置
    std::cout << "Wrote 'a' at put position, the buffer is now: '";
    std::cout.write(a, sizeof a);
    std::cout << "'\n";
    char ch;
    ss >> ch;
    std::cout << "reading at get position gives '" << ch << "'\n";
}

输出： 

put pos = 0 get pos = 0
put pos = 1 get pos = 1
moving both pointers from current position failed
put pos = 1 get pos = 1
put pos = 2 get pos = 1
Wrote 'a' at put position, the buffer is now: '12a'
reading at get position gives '2'

参阅

[虚]
 用绝对寻址重定位输入序列、输出序列或两者中的下一位置指针
(std::basic_streambuf<CharT,Traits> 的虚受保护成员函数)
[虚]
 用相对寻址重定位输入序列、输出序列或两者中的下一位置指针
(std::basic_streambuf<CharT,Traits> 的虚受保护成员函数)
[虚]
 用相对寻址，重定位输入序列、输出序列或两者中的下一位置指针
(std::basic_stringbuf<CharT,Traits,Allocator> 的虚受保护成员函数)
[虚]
 用相对寻址重寻位文件位置
(std::basic_filebuf<CharT,Traits> 的虚受保护成员函数)
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/io/strstreambuf/seekoff&oldid=58039”