std::fpos

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

技术规范

符号索引

外部库

 

输入/输出库

I/O 操纵符

打印函数 (C++23)

C 风格 I/O

缓冲

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98 中弃用)

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 中弃用)

ostrstream (C++98 中弃用)

strstream (C++98 中弃用)

同步的输出

basic_osyncstream (C++20)

类型

streamoff

streamsize

fpos

错误类别接口

iostream_category (C++11)

io_errc (C++11)

 

在标头 <ios> 定义
template< class State > class fpos;

类模板 std::fpos 的特化标识流或文件中的绝对位置。每个 fpos 类型对象保有流中的字节位置（常为 std::streamoff 类型的私有成员）和当前迁移状态，State 类型值（通常是 std::mbstate_t）。

提供下列 std::fpos<std::mbstate_t> 的 typedef 名（尽管它们在标准中拼写方式不同，它们代表同一类型）：

在标头 <iosfwd> 定义
类型	定义
std::streampos	std::fpos<std::char_traits<char>::state_type>
std::wstreampos	std::fpos<std::char_traits<wchar_t>::state_type>
std::u8streampos (C++20)	std::fpos<std::char_traits<char8_t>::state_type>
std::u16streampos (C++11)	std::fpos<std::char_traits<char16_t>::state_type>
std::u32streampos (C++11)	std::fpos<std::char_traits<char32_t>::state_type>

fpos 的所有特化都符合可默认构造 (DefaultConstructible) 、可复制构造 (CopyConstructible) 、可复制赋值 (CopyAssignable) 、可析构 (Destructible) 和可相等比较 (EqualityComparable) 要求。

如果 State 可平凡复制构造，那么 fpos 拥有平凡默认构造函数。 如果 State 可平凡复制赋值，那么 fpos 拥有平凡复制赋值运算符。 如果 State 可平凡析构，那么 fpos 拥有平凡析构函数。

模板形参

State	-	表示迁移状态的类型
类型要求
- State 必须符合可析构 (Destructible) 、可复制赋值 (CopyAssignable) 、可复制构造 (CopyConstructible) 和 可默认构造 (DefaultConstructible) 的要求。

成员函数

state

获取/设置迁移状态的值 (公开成员函数)

另外，提供支持下列操作的成员和非成员函数：

• 默认构造函数，存储零偏移并值初始化状态对象。

• 非 explicit 的构造函数，接受一个（可以是 const 的）std::streamoff 类型参数，存储它的偏移并值初始化状态对象。此构造函数也必须接受特殊值 std::streamoff(-1)：某些流操作返回以此方式构造的 std::fpos 以指示错误。

• 从（可以是 const 的）fpos 到 std::streamoff 的显式转换。结果是存储的偏移。

• 比较两个（可以是 const 的）std::fpos 类型，返回可转换为 bool 的类型的 operator== 和 operator!=。p != q 等价于 !(p == q)。

• operator+ 与 operator-，使得对于（可以是 const 的）fpos<State> 对象 p 和（可以是 const 的）std::streamoff 对象 o：

• p + o 拥有 fpos<State> 类型，而存储的偏移为将 o 加到 p 的结果
• o + p 拥有可转换为 fpos<State> 的类型，而转换结果等于 p + o
• p - o 拥有 fpos<State> 类型，而存储的偏移为从 p 的偏移减去 o 的结果

• operator+= 与 operator-=，能接受一个（可以是 const 的） std::streamoff 并分别对存储的偏移加/减之。

• operator-，能对二个（可以是 const 的）std::fpos 对象相减，产生 std::streamoff，使得对于两个这种对象 p 与 q 有 p == q + (p - q)。

注解

一些输入/输出流成员函数返回并操纵成员 typedef pos_type 类型对象。对于流，这些成员 typedef 由模板形参 Traits 提供，默认为 std::char_traits，它定义它的 pos_type 为 std::fpos 的特化。Traits::pos_type 不是 std::fpos<std::mbstate_t>（别名为 std::streampos、std::wstreampos 等等）时，输入/输出流库的行为由实现定义。

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告	应用于	出版时的行为	正确行为
LWG 57	C++98	streampos 与 wstreampos 被矛盾地在要求相同时允许不同	澄清为相同
P0759R1	C++98	规定不清晰且不完整	已整理
P1148R0	C++11	不明确 u16streampos 和 u32streampos 的定义是什么以及在哪个头文件	使之明确

参阅

streamoff	表示相对的文件/流位置（距 fpos 的偏移），足以表示任何文件大小 (typedef)
tellp	返回输出位置指示器 (std::basic_ostream<CharT,Traits> 的公开成员函数)
seekp	设置输出位置指示器 (std::basic_ostream<CharT,Traits> 的公开成员函数)
fgetpos	获取文件位置指示器 (函数)