手动触发文件分割 - LogRotateFile

函数简介

手动触发日志文件分割，立即关闭当前文件并创建新文件。

接口名称

LogRotateFile

DLL调用

int32_t LogRotateFile(int64_t instance, int64_t loggerHandle);

参数说明

参数名	类型	说明
instance	长整数型	OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
loggerHandle	长整数型	日志实例句柄（0 表示默认实例）

示例

// 手动触发文件分割
int result = LogRotateFile(instance, 0);

// 在特定时机触发分割
LogInfo(instance, "========== 初始化阶段完成 ==========");
LogRotateFile(instance, 0);
LogInfo(instance, "========== 开始运行阶段 ==========");

返回值

1 成功，0 失败。

注意事项

• 立即关闭当前文件并创建新文件
• 不受 LogSetRotationMode 设置的影响，可以随时手动触发
• 新文件名会根据 LogSetFileNamePattern 的设置生成
• 如果使用了 {index} 占位符，序号会自动递增
• 分割后会自动清理超过保留数量的旧文件（根据 LogSetMaxFiles 设置）