public member function
<fstream>

std::basic_ofstream::close

void close();
关闭文件
关闭与对象关联的文件,并将其与流解除关联。

任何待处理的输出序列都将被写入文件。

如果流当前未与任何文件关联(即,没有文件成功地open),则调用此函数将失败。

流的文件关联由其内部流缓冲区维护
内部,该函数调用rdbuf()->close(),并在失败时设置failbit

请注意,当 basic_ofstream 对象被销毁时,任何打开的文件都会被自动关闭。

返回值



如果操作失败(包括在调用前没有文件被open),则会为流设置 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;
}

数据竞争

修改 basic_ofstream 对象。
对同一的并发访问可能会导致数据竞争。

异常安全

基本保证:如果抛出异常,处于有效状态。
由内部操作引发的任何异常都会被该函数捕获,并在关闭文件后重新抛出。
如果函数失败(设置了 failbit 状态标志)并且 exceptions 成员被设置为针对该状态抛出,则它会抛出成员类型为 failure 的异常。

另见