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

 

C++

编译器支持

自由（freestanding）与宿主（hosted）

语言

标准库

标准库头文件

具名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

输入/输出库

I/O 操纵器

打印函数 (C++23)

C 风格 I/O

缓冲区

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

流

抽象

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

文件 I/O

basic_ifstream

basic_ofstream

basic_fstream

字符串 I/O

basic_istringstream

basic_ostringstream

basic_stringstream

数组 I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

同步输出

basic_osyncstream (C++20)

类型

streamoff

streamsize

fpos

错误类别接口

iostream_category (C++11)

io_errc (C++11)

 

std::basic_ostream

全局对象
coutwcout	cerrwcerr	clogwclog
成员函数
basic_ostream::basic_ostream
basic_ostream::~basic_ostream
basic_ostream::operator= (C++11)
格式化输出
basic_ostream::operator<<
非格式化输出
basic_ostream::put
basic_ostream::write
定位
basic_ostream::tellp
basic_ostream::seekp
杂项
basic_ostream::flush
basic_ostream::swap (C++11)
成员类
basic_ostream::sentry
非成员函数
operator<<(std::basic_ostream)
print(std::ostream) (C++23)
println(std::ostream) (C++23)
vprint_unicode(std::ostream) (C++23)
vprint_nonunicode(std::ostream) (C++23)

 

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

缺陷报告	应用于	发布时的行为	正确的行为
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 issue 129 对重载 (2) 的解决方案	恢复

参见

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