设置文件分割模式 - LogSetRotationMode

函数简介

设置日志文件的分割模式，支持按大小、按日期、按小时等多种方式分割日志文件。

接口名称

LogSetRotationMode

DLL调用

int32_t LogSetRotationMode(int64_t instance, int64_t loggerHandle, int32_t rotationMode);

参数说明

参数名类型说明
instance长整数型OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
loggerHandle长整数型日志实例句柄（0 表示默认实例）
rotationMode整数型分割模式（可位或组合），见 LogRotationMode 枚举

LogRotationMode 枚举值

枚举值值说明
OLA_LOG_ROTATION_NONE0不分割（单文件，不推荐）
OLA_LOG_ROTATION_SIZE1<<0按大小分割（默认启用）
OLA_LOG_ROTATION_DAILY1<<1每日分割
OLA_LOG_ROTATION_HOURLY1<<2每小时分割

示例

// 仅按大小分割（默认）
int result = LogSetRotationMode(instance, 0, OLA_LOG_ROTATION_SIZE);

// 每日分割
int result = LogSetRotationMode(instance, 0, OLA_LOG_ROTATION_DAILY);

// 组合使用：按大小和日期分割
int result = LogSetRotationMode(instance, 0, OLA_LOG_ROTATION_SIZE | OLA_LOG_ROTATION_DAILY);

返回值

1 成功，0 失败。

注意事项

  • 默认值：OLA_LOG_ROTATION_SIZE (1) - 仅按大小分割
  • 可以使用位或运算（|）组合多种模式
  • 按大小分割的阈值通过 LogSetMaxFileSize 设置（默认 100MB）
  • 分割后的旧文件数量通过 LogSetMaxFiles 控制（默认保留 10 个）
  • 修改后立即生效，如果日志系统已初始化，会自动重新初始化
  • 组合使用时，满足任一条件都会触发分割
Last Updated: