std::
<basic_ifstream>
类模板 <fstream> template < class charT, class traits = char_traits<charT> > class basic_ifstream; |
ios_base ← basic_ios ← basic_istream ← basic_ifstream
用于操作文件的输入流类.
这个类的对象维护一个basic_filebuf对象作为它们的内部流缓冲区， 它对它们关联的文件执行输入/输出操作(如果有的话)。
文件流在构造时或通过调用成员open与文件相关联。
除了内部文件流缓冲区外，这些类的对象保留了一组继承自ios_base、basic_ios和basic_istream的内部字段:
| 字段 | 成员函数 | 说明 | |
| 格式化 | 格式标志 | flags
setf unsetf |
一组内部标志，影响某些输入/输出操作的解释或生成方式。
参见成员类型fmtflags。 |
| 字段宽度 | width | 下一个要插入的格式化元素的宽度。 | |
| 显示位数 | precision | 下一个插入的浮点值的十进制精度。 | |
| 区域设置 | getloc
imbue |
区域设置对象被函数用于受本地化属性影响的格式化输入/输出操作。 | |
| 填充字符 | fill | 用于填充格式化字段的字符,字段宽度(width)内都填充。 | |
| 状态 | 错误状态 | rdstate
setstate clear |
流的当前错误状态。
单个值可以通过调用good, eof, fail和bad来获得。 参见成员类型iostate。 |
| 异常掩码 | exceptions | 为其抛出失败异常的状态标志。
参见成员类型iostate。 |
|
| 其它 | 回调函数栈 | register_callback | 指向某些事件发生时被调用的函数的堆栈。 |
| 可扩展的数组 | iword
pword xalloc |
用于存储long类型和void*类型对象的内部数组。 | |
| 绑定的流 | tie | 指向输出流的指针，该流在每次i/o操作之前刷新。 | |
| 流缓冲区 | rdbuf | 指向关联的basic_streambuf对象的指针，该对象负责所有输入/输出操作。 | |
| 字符计数 | gcount | 上次输入操作(仅输入流)读取的未格式化的字符数。 |
☞ 模板参数
-
字符类型.
这应该是一个非序列POD类型。
成员类型basic_ifstream::char_type的别名。 -
字符特征类，定义流对象所使用字符的基本属性(参见char_traits).
traits::char_type应与charT相同。
成员类型basic_ifstream::traits_type的别名。
-
charT
-
traits
☞ 模板实例化
| ifstream | 输入文件流类(类) |
| wifstream | 输入文件流类(宽)(类) |
这些实例化在<fstream>中声明。
☞ 成员类型
类声明了以下成员类型:
| 成员类型 | 说明 | 备注 |
| char_type | 第一个模板参数(charT) | |
| traits_type | 第二个模板参数(traits) | 默认为:char_traits <charT> |
| int_type | traits_type::int_type | |
| pos_type | traits_type::pos_type | 一般来说，和streampos相同 |
| off_type | traits_type::off_type | 一般来说，和streamoff相同 |
| event | 事件类型(公共成员类型) |
| event_callback | 事件回调函数类型(公共成员类型) |
| failure | 流异常的基类(公共成员类) |
| fmtflags | 流格式标志的类型(公共成员类型) |
| Init | 初始化标准流对象(公共成员类) |
| iostate | 流状态标志的类型(公共成员类型) |
| openmode | 流打开模式标志的类型(公共成员类型) |
| seekdir | 流方向标志的类型(公共成员类型) |
| sentry | 预备输入流(公共成员类) |
☣ 公共成员函数
| (constructor) | 构造对象(公共成员函数) |
| open | 打开文件(公共成员函数) |
| is_open | 检查文件是否打开(公共成员函数) |
| close | 关闭文件(公共成员函数) |
| rdbuf | 获取流缓冲区(公共成员函数) |
| operator= | 移动赋值(公共成员函数) |
| swap | 内部交换(公共成员函数) |
☣ 继承自basic_istream的公共成员函数
| operator>> | 提取格式化输入(公共成员函数) |
| gcount | 获取字符数(公共成员函数) |
| get | 获取字符(公共成员函数) |
| getline | 获取一行(公共成员函数) |
| ignore | 提取和丢弃字符(公共成员函数) |
| peek | 预览下一个字符(公共成员函数) |
| read | 读取数据块(公共成员函数) |
| readsome | 读取缓冲区中可用的数据(公共成员函数) |
| putback | 把读取的字符放回去(公共成员函数) |
| unget | 把最后一个字符退回到流中(公共成员函数) |
| tellg | 获取输入序列中的位置(公共成员函数) |
| seekg | 设置输入序列中的位置(公共成员函数) |
| sync | 同步输入缓冲区(公共成员函数) |
☣ 继承自basic_ios的公共成员函数
| good | 检查流状态是否良好(公共成员函数) |
| eof | 检查是否设置了eof位(公共成员函数) |
| fail | 检查是否设置了fail位或bad位(公共成员函数) |
| bad | 检查是否设置了bad位(公共成员函数) |
| operator! | 求流的 (not)值(公共成员函数) |
| operator bool | 求流的 (bool)值(公共成员函数) |
| rdstate | 获取错误状态标志(公共成员函数) |
| setstate | 设置错误状态标志(公共成员函数) |
| clear | 设置错误状态标志(公共成员函数) |
| copyfmt | 复制格式信息(公共成员函数) |
| fill | 获取/设置填充字符(公共成员函数) |
| exceptions | 获取/设置错误掩码(公共成员函数) |
| imbue | 本地设置附加属性(公共成员函数) |
| tie | 获取/设置相关的流(公共成员函数) |
| rdbuf | 获取/设置流缓冲区(公共成员函数) |
| narrow | 转换为窄字符(公共成员函数) |
| widen | 转换为宽字符(公共成员函数) |
☣ 继承自ios_base的公共成员函数
| flags | 获取/设置格式标志(公共成员函数) |
| setf | 设置特定的格式标志(公共成员函数) |
| unsetf | 清除特定的格式标志(公共成员函数) |
| precision | 获取/设置浮点小数精度(公共成员函数) |
| width | 获取/设置字段宽度(公共成员函数) |
| imbue | 本地设置附加属性(公共成员函数) |
| getloc | 获取当前的语言环境(公共成员函数) |
| xalloc | 获取可扩展数组的新索引[static](静态公共成员函数) |
| iword | 获取可扩展数组的整型元素(公共成员函数) |
| pword | 获取可扩展数组的指针元素(公共成员函数) |
| 注册事件回调函数register_callback | (公共成员函数) |
| sync_with_stdio | 同步切换c标准输入输出流[static](静态公共成员函数) |
☣ 非成员函数重载
| swap | 交换输入文件流(函数模板) |