XCEngine/docs/api/debug/loglevel/loglevel.md

LogLevel

命名空间: XCEngine::Debug

类型: enum class

头文件: XCEngine/Debug/LogLevel.h

描述: 日志级别枚举，用于区分不同重要程度的日志消息

概述

LogLevel 枚举定义了六个日志级别，从低到高依次为：Verbose、Debug、Info、Warning、Error、Fatal。数值越高表示级别越严重，便于日志系统进行过滤和分类处理。

枚举值

值	数值	描述
Verbose	0	详细日志，用于调试追踪
Debug	1	调试日志，开发时使用
Info	2	信息日志，一般信息提示
Warning	3	警告日志，潜在问题提示
Error	4	错误日志，已发生的错误
Fatal	5	致命日志，导致程序无法继续

公共函数

函数	描述
LogLevelToString	将 LogLevel 转换为字符串表示

LogLevelToString

const char* LogLevelToString(LogLevel level);

将日志级别转换为对应的字符串名称。

参数：

• level - 日志级别值

返回： 对应级别的字符串名称，如 "Verbose"、"Debug"、"Info" 等

示例：

#include <iostream>
#include "XCEngine/Debug/LogLevel.h"

int main() {
    using namespace XCEngine::Debug;

    std::cout << LogLevelToString(LogLevel::Verbose) << std::endl;  // Output: VERBOSE
    std::cout << LogLevelToString(LogLevel::Info) << std::endl;     // Output: INFO
    std::cout << LogLevelToString(LogLevel::Error) << std::endl;    // Output: ERROR

    for (uint8_t i = 0; i <= 5; ++i) {
        LogLevel level = static_cast<LogLevel>(i);
        std::cout << static_cast<int>(level) << ": " << LogLevelToString(level) << std::endl;
    }

    return 0;
}

使用示例

#include "XCEngine/Debug/LogLevel.h"

using namespace XCEngine::Debug;

void ProcessLog(LogLevel level, const char* message) {
    if (level >= LogLevel::Warning) {
        printf("[%s] %s\n", LogLevelToString(level), message);
    }
}

int main() {
    ProcessLog(LogLevel::Verbose, "This is verbose");   // Filtered out
    ProcessLog(LogLevel::Debug, "This is debug");       // Filtered out
    ProcessLog(LogLevel::Info, "This is info");         // Filtered out
    ProcessLog(LogLevel::Warning, "This is warning");   // Output: [WARNING] This is warning
    ProcessLog(LogLevel::Error, "This is error");       // Output: [ERROR] This is error
    ProcessLog(LogLevel::Fatal, "This is fatal");       // Output: [FATAL] This is fatal

    return 0;
}

相关文档

• Debug 模块总览 - Debug 模块介绍