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
不报告错误。 (C++14 前)
若调用返回 (pos_type)-1 ,则执行 setstate(failbit) (C++14 起)

参数

pos - 要设置输出位置指示器到的绝对位置。
off - 要设置输出位置指示器到的相对位置。
dir - 定义应用相对偏移到的基位置。它能为下列常量之一:
 
常量 解释
beg 流的开始
end 流的结尾
cur 流位置指示器的当前位置

返回值

*this

异常

1)exceptions() & failbit != 0 ,则失败情况下可以抛出 std::ios_base::failure
2)
不抛出,除非 rdbuf()->pubseekoff() 抛出。 (C++14 前)
exceptions() & failbit != 0 ,则失败情况下可以抛出 std::ios_base::failure (C++14 起)

示例

#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!

参阅

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