命名空间
变体
操作

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 );
 (在 C++98 中已弃用)
(在 C++26 中已删除)

如果可能，将 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 并且缓冲区是为读取和写入两者打开的，并且 way 是 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(off_type(-1))，如果 pos_type 无法表示结果流位置。

[编辑] 示例

运行此代码
#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';
 
    // absolute positioning both pointers
    ss.rdbuf()->pubseekoff(1, std::ios_base::beg); // move both forward
    std::cout << "put pos = " << ss.tellp()
              << " get pos = " << ss.tellg() << '\n';
 
    // try to move both pointers 1 forward from current position
    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';
 
    // move the write pointer 1 forward, but not the read pointer
    // 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'; // write at put position
    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'

[编辑] 缺陷报告

以下行为更改缺陷报告被追溯地应用于先前发布的 C++ 标准。

DR 应用于 已发布的行为 正确行为
LWG 55 C++98 seekoff 返回了未定义
失败时返回无效流位置		 失败时返回 pos_type(off_type(-1))
在失败时返回

[编辑] 另请参阅

[虚拟]
 使用绝对寻址重置输入序列、输出序列或两者中的下一个指针
(虚拟保护成员函数) [编辑]
[虚拟]
 使用相对寻址重置输入序列、输出序列或两者中的下一个指针
(std::basic_streambuf<CharT,Traits> 的虚拟保护成员函数) [编辑]
[虚拟]
 使用相对寻址重置输入序列、输出序列或两者中的下一个指针
(std::basic_stringbuf<CharT,Traits,Allocator> 的虚拟保护成员函数) [编辑]
[虚拟]
 使用相对寻址重置文件位置
(std::basic_filebuf<CharT,Traits> 的虚拟保护成员函数) [编辑]
检索自 "https://cppreference.cn/mwiki/index.php?title=cpp/io/strstreambuf/seekoff&oldid=170653"