C++

参考

<ostream>

ostream

public member function
<ostream> <iostream>

std::ostream::flush

ostream& flush();
刷新输出流缓冲区
同步关联的流缓冲区与其控制的输出序列。

对于实现中间缓冲区的流缓冲区对象，此函数会请求将所有字符写入控制序列。

内部，该函数通过首先构造一个sentry对象来访问输出序列。然后（如果good），它在其关联的流缓冲区对象上调用pubsync，最后销毁sentry对象，然后返回。

存在一个同名且行为相同的操作符（请参阅flush）。

参数

无

返回值

ostream 对象 (*this)。

错误通过修改 *内部状态标志* 来发出信号。
flagerror
eofbit-
failbit如果 sentry 的构造失败，则可能设置此标志。
badbit同步操作失败（包括函数捕获了内部操作抛出的异常）。
设置时，流的完整性可能受到影响。
多次操作可能设置多个标志。

如果操作设置了一个已注册到成员exceptions的内部状态标志，则该函数将抛出成员类型为failure的异常。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
 
// Flushing files
#include <fstream>      // std::ofstream

int main () {

  std::ofstream outfile ("test.txt");

  for (int n=0; n<100; ++n)
  {
    outfile << n;
    outfile.flush();
  }
  outfile.close();

  return 0;
}

此示例尝试更新文件test.txt的内容100次。

数据竞争

修改流对象。
对同一流对象的并发访问可能导致数据争用，但标准流对象（cout、cerr、clog）在这些对象与stdio同步时除外（在这种情况下，不会发生数据争用，尽管不能保证来自多个线程的字符插入顺序）。

异常安全

基本保证：如果抛出异常，对象处于有效状态。
如果最终的错误状态标志不是goodbit且成员exceptions设置为对该状态进行抛出，则该函数将抛出成员类型为failure的异常。
内部操作抛出的任何异常都会被捕获并由该函数处理，设置badbit。如果在上次调用exceptions时设置了badbit，则该函数会重新抛出捕获到的异常。

另见

flush
刷新流缓冲区 (函数)
endl
插入换行符并刷新 (函数)
istream::sync
同步输入缓冲区 (公共成员函数)