std::basic_stringbuf<CharT,Traits,Allocator>::seekpos
来自cppreference.com
< cpp | io | basic stringbuf
protected: virtual pos_type seekpos( pos_type sp, |
||
在可能时重寻位 std::basic_streambuf::gptr 和/或 std::basic_streambuf::pptr 到 sp 指示的位置。
等效地执行 seekoff(off_type(sp), std::ios_base::beg, which)。
参数
sp | - | 流位置,例如由 seekoff() 或 seekpos() 获得者
| ||||||
which | - | 定义会影响到的输入和/或输出序列。它可以是下列常量之一或它们的组合:
|
返回值
成功时返回 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 的虚受保护成员函数) |