Files
XCEngine/docs/api/XCEngine/Debug/ConsoleLogSink/SetMinimumLevel.md

44 lines
856 B
Markdown
Raw Normal View History

2026-03-26 16:45:24 +08:00
# ConsoleLogSink::SetMinimumLevel
2026-03-26 17:21:44 +08:00
设置该 sink 自己接受的最低日志级别。
2026-03-26 16:45:24 +08:00
```cpp
void SetMinimumLevel(LogLevel level);
```
2026-03-26 17:21:44 +08:00
## 行为说明
2026-03-26 16:45:24 +08:00
2026-03-26 17:21:44 +08:00
这是 sink 级过滤,不是全局过滤。日志只有同时通过了:
2026-03-26 16:45:24 +08:00
2026-03-26 17:21:44 +08:00
- `Logger` 的全局级别与 category 过滤;
- `ConsoleLogSink` 的本地级别过滤;
2026-03-26 16:45:24 +08:00
2026-03-26 17:21:44 +08:00
才会真正输出到控制台。
## 参数
- `level` - 该 sink 允许输出的最小级别。
## 返回值
- 无。
## 线程语义
- 当前实现没有加锁;建议在把 sink 注册到 `Logger` 前完成配置。
## 示例
2026-03-26 16:45:24 +08:00
```cpp
2026-03-26 17:21:44 +08:00
using namespace XCEngine::Debug;
2026-03-26 16:45:24 +08:00
2026-03-26 17:21:44 +08:00
auto sink = std::make_unique<ConsoleLogSink>();
sink->SetMinimumLevel(LogLevel::Warning);
Logger::Get().AddSink(std::move(sink));
2026-03-26 16:45:24 +08:00
```
## 相关文档
2026-03-26 17:21:44 +08:00
- [返回类型总览](ConsoleLogSink.md)
- [Logger::SetMinimumLevel](../Logger/SetMinimumLevel.md)