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)
|