Files
XCEngine/docs/api/XCEngine/Debug/Logger/Fatal.md

46 lines
843 B
Markdown
Raw Normal View History

2026-03-26 16:45:24 +08:00
# Logger::Fatal
2026-03-26 17:21:44 +08:00
`Fatal` 级别记录一条日志。
2026-03-26 16:45:24 +08:00
```cpp
void Fatal(LogCategory category, const Containers::String& message);
```
2026-03-26 17:21:44 +08:00
## 行为说明
2026-03-26 16:45:24 +08:00
2026-03-26 17:21:44 +08:00
这是 `Logger::Log` 的便捷封装,等价于:
2026-03-26 16:45:24 +08:00
2026-03-26 17:21:44 +08:00
```cpp
Log(LogLevel::Fatal, category, message);
```
2026-03-26 16:45:24 +08:00
2026-03-26 17:21:44 +08:00
需要特别注意:在当前版本中,`Fatal` 只是最高严重级别的日志,不会自动终止程序、触发断言中断或抛出异常。`XE_ASSERT` 也是基于这个行为实现的。
2026-03-26 16:45:24 +08:00
2026-03-26 17:21:44 +08:00
## 参数
- `category` - 日志分类。
- `message` - 致命错误文本。
## 返回值
2026-03-26 16:45:24 +08:00
2026-03-26 17:21:44 +08:00
- 无。
## 线程语义
- 与 [Log](Log.md) 相同。
## 示例
```cpp
XCEngine::Debug::Logger::Get().Fatal(
XCEngine::Debug::LogCategory::General,
"Unexpected unrecoverable state"
);
2026-03-26 16:45:24 +08:00
```
## 相关文档
2026-03-26 17:21:44 +08:00
- [返回类型总览](Logger.md)
- [Log](Log.md)
- [Error](Error.md)