std::strstreambuf::seekoff
< cpp | io | strstreambuf
protected: virtual pos_type seekoff(off_type off, |
||
若可能,则重寻位 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 | - | 定义要应用相对偏移到的基位置。它能为下列常量之一:
| ||||||||||
which | - | 定义影响输入序列、输出序列或两者。它能为下列常量之一或其组合:
|
返回值
成功时为 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> 的虚受保护成员函数) |