std::basic_ostream<CharT,Traits>::seekp
来自cppreference.com
< cpp | io | basic ostream
basic_ostream& seekp( pos_type pos ); |
(1) | |
basic_ostream& seekp( off_type off, std::ios_base::seekdir dir ); |
(2) | |
设置当前关联 streambuf
对象的输出位置指示器。
表现为无格式输出函数 (UnformattedOutputFunction) (除了不实际进行输出)。在构造并检查 sentry 对象后, |
(C++11 起) |
1) 通过调用 rdbuf()->pubseekpos(pos, std::ios_base::out) ,设置输出位置指示器为绝对(相对于文件起始)值
pos
。若调用返回 (pos_type)-1 ,则执行 setstate(failbit) 。2) 通过调用 rdbuf()->pubseekoff(off, dir, std::ios_base::out) 设置输出位置指示器为相对于
dir
的偏移 off
。若调用返回 (pos_type)-1 ,则执行 setstate(failbit) 。参数
pos | - | 要设置输出位置指示器到的绝对位置。 | ||||||||
off | - | 要设置输出位置指示器到的相对位置(正或负)。 | ||||||||
dir | - | 定义应用相对偏移到的基位置。它能为下列常量之一:
|
返回值
*this
异常
示例
运行此代码
#include <sstream> #include <iostream> int main() { std::ostringstream os("hello, world"); os.seekp(7); os << 'W'; os.seekp(0, std::ios_base::end); os << '!'; os.seekp(0); os << 'H'; std::cout << os.str() << '\n'; }
输出:
Hello, World!
缺陷报告
下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。
DR | 应用于 | 出版时的行为 | 正确行为 |
---|---|---|---|
LWG 2341 | C++98 | 二个重载在失败时表现有别 | 使之一致 |
参阅
返回输出位置指示器 (公开成员函数) | |
返回输入位置指示器 ( std::basic_istream<CharT,Traits> 的公开成员函数) | |
设置输入位置指示器 ( std::basic_istream<CharT,Traits> 的公开成员函数) |