命名空间
变体
操作

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(除了不实际执行输出)。在构造和检查哨兵对象后,

(自 C++11 起)
1) 如果 fail() != true,则通过调用 rdbuf()->pubseekpos(pos, std::ios_base::out) 将输出位置指示器设置为绝对值(相对于文件开头)pos。如果失败,则调用 setstate(std::ios_base::failbit)
2) 如果 fail() != true,则通过调用 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++ 标准。

DR 应用于 已发布的行为 正确行为
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 针对重载 (2) 的 LWG 问题 129 的解决方案已删除 恢复

[编辑] 另请参阅

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