C++ 参考手册

std::ios_base

定义于头文件 <ios>
class ios_base;

类 ios_base 是作为所有 I/O 流类的基类工作的多用途类。它维护数种数据：

1) 状态信息：流状态标志；
2) 控制信息：控制输入和输出序列格式化和感染的本地环境的标志；
3) 私有存储：允许 long 和 void* 成员的有下标可扩展数据结构，它可以实现为二个任意长度的数组，或二元素结构体的单个数组，或另一容器；
4) 回调：从 imbue() 、 copyfmt() 和 ~ios_base() 调用的任意数量用户定义函数。

典型实现保有对应下列 fmtflags 、 iostate 、 openmode 及 seekdir 所有值的成员常量，维护当前精度、宽度、格式化标志、异常掩码、缓冲区错误状态、保有回调的可调大小容器、当前感染的 locale 、私有存储的成员变量及 xalloc() 所用的静态整数变量。

成员函数

 构造对象
(受保护成员函数)
[虚]
 析构对象
(虚公开成员函数)
格式化
管理格式标志
(公开成员函数)
设置特定格式标志
(公开成员函数)
清除特定格式的标志
(公开成员函数)
管理浮点操作的精度
(公开成员函数)
管理域的宽度
(公开成员函数)
本地环境
设置本地环境
(公开成员函数)
返回当前本地环境
(公开成员函数)
内部可扩展数组
[静态]
 返回能安全用作 pword() 和 iword() 下标的程序范围内独有的整数
(公开静态成员函数)
如果有必要的话，调整私有存储的大小，并且访问位于提供的下标的long元素
(公开成员函数)
若需要则重置私有存储的大小，并访问位于指定下标的 void* 元素
(公开成员函数)
杂项
注册事件回调函数
(公开成员函数)
[静态]
 设置C++和C的IO库是否可以互操作
(公开静态成员函数)

成员类

 流异常
(公开成员类)
初始化标准流对象
(公开成员类)

成员类型与常量

 
类型 解释
流打开模式类型

亦定义下列常量：

 
常量 解释
app 每次写入前寻位到流结尾
binary 以二进制模式打开
in 为读打开
out 为写打开
trunc 在打开时舍弃流的内容
ate 打开后立即寻位到流结尾

(typedef)
格式化标志类型

亦定义下列常量：

 
常量 解释
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)
流状态类型

亦定义下列常量：

 
常量 解释
goodbit 无错误
badbit 不可恢复的流错误
failbit 输入/输出操作失败（格式化或提取错误）
eofbit 关联的输出序列已抵达文件尾

(typedef)
寻位方向类型

亦定义下列常量：

 
常量 解释
beg 流的开始
end 流的结尾
cur 流位置指示器的当前位置

(typedef)
指定事件类型
(枚举)
回调函数类型
(typedef)
弃用的成员类型
 
类型 解释
io_state(弃用) 可以像 iostate 一样使用的整数类型
open_mode(弃用) 可以像 openmode 一样使用的整数类型
seek_dir(弃用) 可以像 seekdir 一样使用的整数类型
streamoff(弃用) 可以像 off_type 一样使用的未指定类型，不必是 std::streamoff
streampos(弃用) 可以像 pos_type 一样使用的未指定类型，不必是 std::streampos
(C++17 前)