设置文件追加模式 - LogSetAppendMode

函数简介

设置日志文件的追加模式，控制程序重启后是继续追加到现有文件还是创建新文件。

接口名称

LogSetAppendMode

DLL调用

int32_t LogSetAppendMode(int64_t instance, int64_t loggerHandle, int32_t enableAppend)

参数说明

参数名	类型	说明
instance	int64_t	OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成
loggerHandle	int64_t	日志实例句柄（0 表示默认实例）
enableAppend	int32_t	是否启用追加（1 启用，0 禁用）

示例

// 启用追加模式（默认）
int result = LogSetAppendMode(instance, 0, 1);
// 程序重启后继续追加到现有文件

// 禁用追加模式
int result = LogSetAppendMode(instance, 0, 0);
// 程序重启后将现有文件重命名为备份，创建新文件

// 实际应用场景
// 场景1：长期运行的服务，希望日志连续
LogSetAppendMode(instance, 0, 1);
LogSetRotationMode(instance, 0, OLA_LOG_ROTATION_SIZE | OLA_LOG_ROTATION_DAILY);

// 场景2：每次启动都希望有新的日志文件
LogSetAppendMode(instance, 0, 0);
LogSetFileNamePattern(instance, 0, "app_{datetime}.log");

返回值

返回值	说明
0	失败
1	成功

注意事项

• 默认值：1（启用追加）
• 启用追加模式时：
  • 程序重启后继续追加到现有文件
  • 适合长期运行的服务程序
  • 需要配合文件分割机制避免文件过大
• 禁用追加模式时：
  • 程序重启后会将现有文件重命名为备份（添加时间戳后缀）
  • 然后创建新的日志文件
  • 适合需要明确区分每次运行的场景
• 修改后立即生效，如果日志系统已初始化，会自动重新初始化
• 建议配合 LogSetFileNamePattern 使用时间戳占位符，避免文件名冲突