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

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

virtual pos_type seekoff( off_type off,
                          std::ios_base::seekdir dir,

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

在可能时重寻位 std::basic_streambuf::gptr 和/或 std::basic_streambuf::pptr 到对应距流的获取和/或放置区起始、结尾或当前位置 off 个字符的位置。

如果重寻位了指针（gptr 和/或 pptr），那么它会按下列方式进行：

1) 确定 off_type 类型的新指针偏移 newoff：
a) 如果 dir == std::ios_base::beg，那么 newoff 为零
b) 如果 dir == std::ios_base::cur，那么 newoff 是指针的当前位置（gptr() - eback() 或 pptr() - pbase()）
c) 如果 dir == std::ios_base::end，那么 newoff 是缓冲区的整个已初始化部分的长度（使用过分配时就是高水位指针减起始指针）
2) 如果要重寻位的指针是空指针且新偏移 newoff 非零，那么函数失败。
3) 如果 newoff + off < 0（重寻位会移动指针到缓冲区的起始指针之前）或 newoff + off 会指向缓冲区结尾后（或在使用过分配时指向缓冲区中最后的未初始化字符后），那么函数失败。
4) 否则，如同以 gptr() = eback() + newoff + off 或 pptr() = pbase() + newoff + off 赋值指针。

参数

off - 要设置下一位置指针到的相对位置
dir - 定义应用偏移到的基位置。它可以是下列常量之一：
常量 解释
beg 流的开始
end 流的结尾
cur 流位置指示器的当前位置
which - 定义会影响到的输入和/或输出序列。它可以是下列常量之一或它们的组合：
常量 解释
in 影响输入序列
out 影响输出序列

返回值

成功时返回 pos_type(newoff)，失败时或 pos_type 不能表示结果流位置时返回 pos_type(off_type(-1))。

示例

运行此代码
#include <iostream>
#include <sstream>
 
int main()
{
    std::stringstream ss("123"); // 入/出
    std::cout << "写入位置 = " << ss.tellp()
              << " 读取位置 = " << ss.tellg() << '\n';
 
    // 两个指针绝对寻位
    ss.rdbuf()->pubseekoff(1, std::ios_base::beg); // 都前移 1
    std::cout << "写入位置 = " << ss.tellp()
              << " 读取位置 = " << ss.tellg() << '\n';
 
    // 试图从当前位置前移两个指针 1
    if (-1 == ss.rdbuf()->pubseekoff(1, std::ios_base::cur))
        std::cout << "从当前位置前移两个指针失败\n";
    std::cout << "写入位置 = " << ss.tellp()
              << " 读取位置 = " << ss.tellg() << '\n';
 
    // 前移写指针 1 ，但不前移读指针
    // 也可以调用 ss.seekp(1, std::ios_base::cur);
    ss.rdbuf()->pubseekoff(1, std::ios_base::cur, std::ios_base::out);
    std::cout << "写入位置 = " << ss.tellp()
              << " 读取位置 = " << ss.tellg() << '\n';
 
    ss << 'a'; // 在写入位置写入
    std::cout << "在写入位置写入 'a'，现在缓冲区是 " << ss.str() << '\n';
 
    char ch;
    ss >> ch;
    std::cout << "在读取位置读取到了 '" << ch << "'\n";
}

输出： 

写入位置 = 0 读取位置 = 0
写入位置 = 1 读取位置 = 1
从当前位置前移两个指针失败
写入位置 = 1 读取位置 = 1
写入位置 = 2 读取位置 = 1
在写入位置写入 'a'，现在缓冲区是 12a
在读取位置读取到了 '2'

缺陷报告

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

缺陷报告 应用于 出版时的行为 正确行为
LWG 55 C++98 seekoff 在失败时返回了未定义的无效流位置 失败时返回 pos_type(off_type(-1))
LWG 375 C++98 std::ios_base 的静态常量成员被误指定为 std::basic_ios 的成员 已修正
LWG 432 C++98 seekoff 在 newoff + off 会指向缓冲区中
最后的未初始化字符后的情况下也可能会成功 		此时 seekoff 会失败
LWG 453 C++98 在新指针偏移为零的情况下重寻位空的 gptr() 或 pptr() 始终会失败 此时重寻位可以成功
LWG 563 C++98 在解决 LWG 问题 432 后程序无法精确控制
结束指针，因此它不能再用于计算 newoff 		改用高水位指针

参阅

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