XCEngine/docs/api/XCEngine/Debug/FileLogSink/Flush.md

# FileLogSink::Flush

把底层文件缓冲区刷新到磁盘。

```cpp
void Flush() override;
```

## 行为说明

当前实现直接转发到 `Core::FileWriter::Flush()`。如果文件尚未成功打开，`FileWriter` 会返回 `false`，但 `FileLogSink::Flush` 本身不会上报错误。

需要注意的是，当前 `FileLogSink::Log` 在每次写入后已经主动调用一次 `Flush`，因此手动调用更多是为了表达语义，而不是补齐缺失步骤。

## 参数

- 无。

## 返回值

- 无。

## 线程语义

- 通过 `Logger` 使用时通常是串行的。

## 示例

```cpp
XCEngine::Debug::FileLogSink sink("engine.log");
sink.Flush();
```

## 相关文档

- [返回类型总览](FileLogSink.md)
- [Log](Log.md)