C++

参考

<fstream>

basic_fstream

public member function
<fstream>

std::basic_fstream::open

void open (const char* filename,           ios_base::openmode mode = ios_base::in | ios_base::out);
void open (const char* filename,           ios_base::openmode mode = ios_base::in | ios_base::out);void open (const string& filename,           ios_base::openmode mode = ios_base::in | ios_base::out);
打开文件
打开由参数 filename 标识的文件，并将其与流对象关联，以便对文件的内容执行输入/输出操作。参数 mode 指定了打开模式。

如果流已关联到一个文件（即它已经打开），调用此函数将失败。

流的文件关联由其内部流缓冲区维护
在内部，该函数调用 rdbuf()->open(filename,mode)

如果失败，函数会将 failbit 设置到流中。
成功时，函数会清除流的状态标志（将其设置为 goodbit）。
失败时，会设置 failbit。

参数

filename
包含要打开的文件的名称的字符串。
有关其格式和有效性的具体说明取决于库实现和运行环境。
mode
描述文件请求的输入/输出模式的标志。
这是一个位掩码成员类型 openmode 的对象，由以下成员常量的组合构成：
成员常量代表access
in输入为读取而打开文件：内部流缓冲区支持输入操作。
下可用的类型输出为写入而打开文件：内部流缓冲区支持输出操作。
binarybinary操作以二进制模式执行，而非文本模式。
ate在末尾输出位置从文件末尾开始。
appappend (追加)所有输出操作都在文件末尾进行，追加到其现有内容。
trunctruncate (截断)文件打开前存在的任何内容都将被丢弃。
这些标志可以通过按位或运算符（|）组合。

如果模式同时设置了 trunc 和 app，则打开操作失败。如果仅设置了其中一个但未设置 out，或者同时设置了 app 和 in，则也失败。
如果模式同时设置了 trunc 和 app，则打开操作失败。如果设置了 trunc 但未设置 out，操作也会失败。

返回值

无

如果函数未能打开文件，则为流设置 failbit 状态标志（如果该状态标志已通过成员 exceptions 注册，则可能会抛出 ios_base::failure）。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
 
// fstream::open / fstream::close
#include <fstream>      // std::fstream

int main () {

  std::fstream fs;
  fs.open ("test.txt", std::fstream::in | std::fstream::out | std::fstream::app);

  fs << " more lorem ipsum";

  fs.close();

  return 0;
}

数据竞争

修改 basic_fstream 对象。
对同一流对象的并发访问会引入数据竞争。

异常安全

基本保证：如果抛出异常，流处于有效状态。
如果函数失败（设置了 failbit 状态标志）并且 exceptions 成员被设置为对此状态抛出异常，则抛出成员类型为 failure 的异常。

另见

basic_fstream::is_open
检查文件是否打开 (公开成员函数)
basic_fstream::close
关闭文件 (公开成员函数)
basic_filebuf::open
打开文件 (公开成员函数)