C++

参考

<fstream>

、ofstream

public member function
<fstream>

std::ofstream::open

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

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

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

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

参数

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

如果模式同时设置了 trunc 和 app，则打开操作失败。如果同时设置了 app 和 in，也会失败。
如果模式同时设置了 trunc 和 app，则打开操作失败。

返回值

无

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

示例

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

int main () {

  std::ofstream ofs;
  ofs.open ("test.txt", std::ofstream::out | std::ofstream::app);

  ofs << " more lorem ipsum";

  ofs.close();

  return 0;
}

数据竞争

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

异常安全

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

另见

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