std::basic_ostream<CharT,Traits>::seekp

来自cppreference.com
 
C++
 
输入/输出库
 
std::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。失败的情况下会调用 setstate(std::ios_base::failbit)。
2) 通过调用 rdbuf()->pubseekoff(off, dir, std::ios_base::out) 设置输出位置指示器为相对于 dir 的偏移 off。失败的情况下会调用 setstate(std::ios_base::failbit)。

参数

pos - 要设置输出位置指示器到的绝对位置。
off - 要设置输出位置指示器到的相对位置（正或负）。
dir - 定义应用相对偏移量的基位置。它可以是下列常量之一：
常量 解释
beg 流的开始
end 流的结尾
cur 流位置指示器的当前位置

返回值

*this

异常

1,2) 如果 exceptions() & failbit != 0，那么失败时可能抛出 std::ios_base::failure。

示例

运行此代码
#include <iostream>
#include <sstream>

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++ 标准。

缺陷报告 应用于 出版时的行为 正确行为
LWG 129 C++98 没有途径指示操作失败 失败时会设置 failbit
LWG 136 C++98 seekp 可以设置输入流 只设置输出流
LWG 537 C++98 1. pos 的类型是 pos_type&
2. off 的类型是 off_type& 		1. 改成 pos_type
2. 改成 off_type
LWG 2341 C++98 LWG 问题 129 的解决方案中关于重载 (2) 的部分被移除 已恢复

参阅

 返回输出位置指示器
(公开成员函数)
返回输入位置指示器
(std::basic_istream<CharT,Traits> 的公开成员函数)
设置输入位置指示器
(std::basic_istream<CharT,Traits> 的公开成员函数)