std::basic_iostream

 

C++

编译器支持

独立式和托管式

语言

标准库

标准库头文件

具名要求

特性测试宏 (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_iostream

成员函数

basic_iostream::basic_iostream

basic_iostream::~basic_iostream

受保护的成员函数

basic_iostream::operator=

basic_iostream::swap

 

定义于头文件 <istream>
template<     class CharT,     class Traits = std::char_traits<CharT> > class basic_iostream :       public basic_istream<CharT, Traits>,       public basic_ostream<CharT, Traits>

类模板 basic_iostream 为流上的高级输入/输出操作提供支持。 支持的操作包括顺序读取或写入和格式化。 此功能通过 std::basic_streambuf 类提供的接口实现。 它通过 std::basic_ios 类访问。

继承图

提供了用于常见字符类型的数个 typedef

定义于头文件 <istream>
类型	定义
std::iostream	std::basic_iostream<char>
std::wiostream	std::basic_iostream<wchar_t>

成员类型

成员类型	定义
char_type	CharT
traits_type	Traits；如果 Traits::char_type 不是 CharT，则程序是非良构的。
int_type	Traits::int_type
pos_type	Traits::pos_type
off_type	Traits::off_type

成员函数

（构造函数）	构造对象 （公有成员函数）
（析构函数） [虚函数]	析构对象 （虚公有成员函数）

受保护的成员函数

operator= (C++11)	移动赋值另一个 basic_iostream （受保护的成员函数）
swap (C++11)	与另一个 basic_iostream 交换状态 （公有成员函数）

继承自 std::basic_istream

成员函数

格式化输入
operator>>	提取格式化数据 （std::basic_istream<CharT,Traits> 的公有成员函数）
未格式化输入
get	提取字符 （std::basic_istream<CharT,Traits> 的公有成员函数）
peek	读取下一个字符但不提取它 （std::basic_istream<CharT,Traits> 的公有成员函数）
unget	取消提取一个字符 （std::basic_istream<CharT,Traits> 的公有成员函数）
putback	将字符放回输入流 （std::basic_istream<CharT,Traits> 的公有成员函数）
getline	提取字符直到找到给定字符 （std::basic_istream<CharT,Traits> 的公有成员函数）
ignore	提取并丢弃字符直到找到给定字符 （std::basic_istream<CharT,Traits> 的公有成员函数）
read	提取字符块 （std::basic_istream<CharT,Traits> 的公有成员函数）
readsome	提取已就绪可用的字符块 （std::basic_istream<CharT,Traits> 的公有成员函数）
gcount	返回上一次未格式化输入操作提取的字符数 （std::basic_istream<CharT,Traits> 的公有成员函数）
定位
tellg	返回输入位置指示器 （std::basic_istream<CharT,Traits> 的公有成员函数）
seekg	设置输入位置指示器 （std::basic_istream<CharT,Traits> 的公有成员函数）
杂项
sync	与底层存储设备同步 （std::basic_istream<CharT,Traits> 的公有成员函数）

成员类

sentry

为准备流以进行输入操作实现基本逻辑 （std::basic_istream<CharT,Traits> 的公有成员类）

继承自 std::basic_ostream

成员函数

格式化输出
operator<<	插入格式化数据 （std::basic_ostream<CharT,Traits> 的公有成员函数）
未格式化输出
put	插入一个字符 （std::basic_ostream<CharT,Traits> 的公有成员函数）
write	插入字符块 （std::basic_ostream<CharT,Traits> 的公有成员函数）
定位
tellp	返回输出位置指示器 （std::basic_ostream<CharT,Traits> 的公有成员函数）
seekp	设置输出位置指示器 （std::basic_ostream<CharT,Traits> 的公有成员函数）
杂项
flush	与底层存储设备同步 （std::basic_ostream<CharT,Traits> 的公有成员函数）

成员类

sentry

为准备流以进行输出操作实现基本逻辑 （std::basic_ostream<CharT,Traits> 的公有成员类）

继承自 std::basic_ios

成员类型

成员类型	定义
char_type	CharT
traits_type	Traits
int_type	Traits::int_type
pos_type	Traits::pos_type
off_type	Traits::off_type

成员函数

状态函数
good	检查是否没有错误发生，即 I/O 操作是否可用 （std::basic_ios<CharT,Traits> 的公有成员函数）
eof	检查是否已到达文件末尾 （std::basic_ios<CharT,Traits> 的公有成员函数）
fail	检查是否发生错误 （std::basic_ios<CharT,Traits> 的公有成员函数）
bad	检查是否发生不可恢复的错误 （std::basic_ios<CharT,Traits> 的公有成员函数）
operator!	检查是否发生错误（fail() 的同义词） （std::basic_ios<CharT,Traits> 的公有成员函数）
operator bool	检查是否没有错误发生（!fail() 的同义词） （std::basic_ios<CharT,Traits> 的公有成员函数）
rdstate	返回状态标志 （std::basic_ios<CharT,Traits> 的公有成员函数）
setstate	设置状态标志 （std::basic_ios<CharT,Traits> 的公有成员函数）
clear	修改状态标志 （std::basic_ios<CharT,Traits> 的公有成员函数）
格式化
copyfmt	复制格式化信息 （std::basic_ios<CharT,Traits> 的公有成员函数）
fill	管理填充字符 （std::basic_ios<CharT,Traits> 的公有成员函数）
杂项
exceptions	管理异常掩码 （std::basic_ios<CharT,Traits> 的公有成员函数）
imbue	设置区域设置 （std::basic_ios<CharT,Traits> 的公有成员函数）
rdbuf	管理关联的流缓冲区 （std::basic_ios<CharT,Traits> 的公有成员函数）
tie	管理绑定的流 （std::basic_ios<CharT,Traits> 的公有成员函数）
narrow	窄化字符 （std::basic_ios<CharT,Traits> 的公有成员函数）
widen	宽化字符 （std::basic_ios<CharT,Traits> 的公有成员函数）

继承自 std::ios_base

成员函数

格式化
flags	管理格式标志 （std::ios_base 的公有成员函数）
setf	设置特定格式标志 （std::ios_base 的公有成员函数）
unsetf	清除特定格式标志 （std::ios_base 的公有成员函数）
precision	管理浮点运算的十进制精度 （std::ios_base 的公有成员函数）
width	管理字段宽度 （std::ios_base 的公有成员函数）
区域设置
imbue	设置区域设置 （std::ios_base 的公有成员函数）
getloc	返回当前区域设置 （std::ios_base 的公有成员函数）
内部可扩展数组
xalloc [静态]	返回一个程序范围唯一的整数，可以安全地用作 pword() 和 iword() 的索引 （std::ios_base 的公有静态成员函数）
iword	如有必要，调整私有存储的大小，并访问给定索引处的 long 元素 （std::ios_base 的公有成员函数）
pword	如有必要，调整私有存储的大小，并访问给定索引处的 void* 元素 （std::ios_base 的公有成员函数）
杂项
register_callback	注册事件回调函数 （std::ios_base 的公有成员函数）
sync_with_stdio [静态]	设置 C++ 和 C I/O 库是否可互操作 （std::ios_base 的公有静态成员函数）
成员类
failure	流异常 （std::ios_base 的公有成员类）
Init	初始化标准流对象 （std::ios_base 的公有成员类）

成员类型和常量
类型	说明
openmode	流打开模式类型 以下常量也被定义 常量 说明 app 每次写入前定位到流的末尾 binary 以 二进制模式 打开 in 为读取而打开 out 为写入而打开 trunc 打开时丢弃流的内容 ate 打开后立即定位到流的末尾 noreplace (C++23) 以独占模式打开 （typedef）
fmtflags	格式化标志类型 以下常量也被定义 常量 说明 dec 对整数 I/O 使用十进制基数：参见 std::dec oct 对整数 I/O 使用八进制基数：参见 std::oct hex 对整数 I/O 使用十六进制基数：参见 std::hex basefield dec | oct | hex。 用于掩码操作 left 左对齐调整（向右添加填充字符）：参见 std::left right 右对齐调整（向左添加填充字符）：参见 std::right internal 内部调整（向内部指定点添加填充字符）：参见 std::internal adjustfield left | right | internal。 用于掩码操作 scientific 使用科学记数法生成浮点类型，或者如果与 fixed 结合使用，则使用十六进制记数法：参见 std::scientific fixed 使用定点记数法生成浮点类型，或者如果与 scientific 结合使用，则使用十六进制记数法：参见 std::fixed floatfield scientific | fixed。 用于掩码操作 boolalpha 以字母数字格式插入和提取 bool 类型：参见 std::boolalpha showbase 为整数输出生成指示数字基数的前缀，在货币 I/O 中需要货币指示符：参见 std::showbase showpoint 为浮点数输出无条件生成小数点字符：参见 std::showpoint showpos 为非负数输出生成 + 字符：参见 std::showpos skipws 在某些输入操作之前跳过前导空白符：参见 std::skipws unitbuf 在每次输出操作后刷新输出：参见 std::unitbuf uppercase 在某些输出操作中，将某些小写字母替换为其大写等效字母：参见 std::uppercase (typedef)
iostate	流类型的状态 以下常量也被定义 常量 说明 goodbit 无错误 badbit 不可恢复的流错误 failbit 输入/输出操作失败（格式化或提取错误） eofbit 关联的输入序列已到达文件末尾 (typedef)
seekdir	查找方向类型 以下常量也被定义 常量 说明 beg 流的开始 end 流的结尾 cur 流位置指示器的当前位置 (typedef)
event	指定事件类型 (enum)
event_callback	回调函数类型 (typedef)

缺陷报告

以下行为变更缺陷报告已追溯应用于先前发布的 C++ 标准。

DR	应用于	已发布行为	正确行为
LWG 271	C++98	成员类型 char_type、traits_type、int_type、pos_type 和 off_type 未定义 (std::basic_istream 和 std::basic_ostream 均定义了这些类型，导致歧义)	定义 这些类型

参见

• 输入/输出操纵符