创建日志实例 - LogCreateInstance

函数简介

创建新的日志实例，用于实现多实例日志管理。

接口名称

LogCreateInstance

DLL调用

int64_t LogCreateInstance(int64_t instance, const char* instanceName)

参数说明

参数名类型说明
instanceint64_tOLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成
instanceNamestring实例名称（用于标识，如 "NetworkLogger"）

示例

// 创建网络日志实例
int64_t networkLogger = LogCreateInstance(instance, "NetworkLogger");
if (networkLogger != 0) {
    LogSetModuleName(instance, networkLogger, "network");
    LogSetFilePath(instance, networkLogger, "./logs/network.log");
    LogInfoEx(instance, networkLogger, "网络日志初始化成功");
}

// 创建数据库日志实例
int64_t dbLogger = LogCreateInstance(instance, "DatabaseLogger");
if (dbLogger != 0) {
    LogSetModuleName(instance, dbLogger, "database");
    LogSetFilePath(instance, dbLogger, "./logs/database.log");
    LogSetLevel(instance, dbLogger, OLA_LOG_LEVEL_DEBUG);
}

// 创建UI日志实例
int64_t uiLogger = LogCreateInstance(instance, "UILogger");
if (uiLogger != 0) {
    LogSetModuleName(instance, uiLogger, "ui");
    LogSetTarget(instance, uiLogger, OLA_LOG_TARGET_CONSOLE);  // 只输出到控制台
}

// 使用不同实例记录日志
LogInfoEx(instance, networkLogger, "网络连接成功");
LogDebugEx(instance, dbLogger, "执行SQL查询");
LogInfoEx(instance, uiLogger, "界面加载完成");

返回值

返回值类型说明
int64_t日志实例句柄，失败返回 0

注意事项

  • 新创建的实例使用默认配置
  • 实例句柄必须通过 LogDestroyInstance 释放
  • 默认实例（句柄 = 0）无需创建，始终存在
  • 每个实例可以有独立的配置（路径、级别、格式等）
  • 适合需要分类管理日志的场景（按模块、按功能等）
Last Updated: