OLA 文档中心

主题

2026-08-20

设置最多保留文件数量 - LogSetMaxFiles ​

函数简介 ​

设置最多保留的日志文件数量，超过此数量时，最旧的日志文件会被自动删除。

接口名称 ​

LogSetMaxFiles

DLL调用 ​

c
int32_t LogSetMaxFiles(int64_t instance, int64_t loggerHandle, int32_t maxFiles);

参数说明 ​

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

示例 ​

保留最近 20 个文件；可配合 LogCleanupOldFiles 立即清理。

SDK 调用 ​

cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
const int64_t logger = 0; // 默认实例

ola.LogSetBaseDirectory(logger, "D:\\logs");
ola.LogSetFileNamePattern(logger, "app_{date}_{index}.log");
int ret = ola.LogSetMaxFiles(logger, 20); // 保留 20 个
if (ret != 1) {
    return;
}
ola.LogInfo("keep at most 20 files");
// 立即清理可用：LogCleanupOldFiles(logger, -1) 使用上述配置值
csharp
using System;
using OLAPlug;

var ola = new OLAPlugServer();
long logger = 0;

ola.LogSetBaseDirectory(logger, @"D:\logs");
ola.LogSetFileNamePattern(logger, "app_{date}_{index}.log");
int ret = ola.LogSetMaxFiles(logger, 20); // 保留 20 个
if (ret != 1) return;
ola.LogInfo("keep at most 20 files");
// 立即清理可用：LogCleanupOldFiles(logger, -1) 使用上述配置值
python
from OLAPlugServer import OLAPlugServer

ola = OLAPlugServer()
logger = 0

ola.LogSetBaseDirectory(logger, r"D:\logs")
ola.LogSetFileNamePattern(logger, "app_{date}_{index}.log")
ret = ola.LogSetMaxFiles(logger, 20)  # 保留 20 个
if ret != 1:
    raise RuntimeError("failed")
ola.LogInfo("keep at most 20 files")
# 立即清理可用：LogCleanupOldFiles(logger, -1) 使用上述配置值
java
import com.olaplug.OLAPlugServer;

OLAPlugServer ola = new OLAPlugServer();
long logger = 0;

ola.LogSetBaseDirectory(logger, "D:\\logs");
ola.LogSetFileNamePattern(logger, "app_{date}_{index}.log");
int ret = ola.LogSetMaxFiles(logger, 20); // 保留 20 个
if (ret != 1) {
    return;
}
ola.LogInfo("keep at most 20 files");
// 立即清理可用：LogCleanupOldFiles(logger, -1) 使用上述配置值
go
import "github.com/ola/olaplug/olaplug"

ola, _ := olaplug.NewOLAPlugServer("OLAPlug_x64.dll")
defer ola.ReleaseObj()
logger := int64(0)

ola.LogSetBaseDirectory(logger, `D:\logs`)
ola.LogSetFileNamePattern(logger, "app_{date}_{index}.log")
ret := ola.LogSetMaxFiles(logger, 20) // 保留 20 个
if ret != 1 {
    return
}
ola.LogInfo("keep at most 20 files")
// 立即清理可用：LogCleanupOldFiles(logger, -1) 使用上述配置值
rust
use olaplug::OLAPlugServer;

let ola = OLAPlugServer::new("OLAPlug_x64.dll").unwrap();
let logger = 0i64;

ola.log_set_base_directory(logger, r"D:\logs");
ola.log_set_file_name_pattern(logger, "app_{date}_{index}.log");
let ret = ola.log_set_max_files(logger, 20); // 保留 20 个
if ret != 1 {
    return;
}
ola.log_info("keep at most 20 files");
// 立即清理可用：LogCleanupOldFiles(logger, -1) 使用上述配置值
cpp
var ola = com("OlaPlug.OlaSoft")
var logger = 0

ola.LogSetBaseDirectory(logger, "D:\\logs")
ola.LogSetFileNamePattern(logger, "app_{date}_{index}.log")
var ret = ola.LogSetMaxFiles(logger, 20) // 保留 20 个
if(ret == 1) {
    ola.LogInfo("keep at most 20 files")
    // 立即清理可用：LogCleanupOldFiles(logger, -1) 使用上述配置值
}
vbscript
Set ola = CreateObject("OlaPlug.OlaSoft")
logger = 0

ola.LogSetBaseDirectory logger, "D:\logs"
ola.LogSetFileNamePattern logger, "app_{date}_{index}.log"
ret = ola.LogSetMaxFiles(logger, 20)
If ret = 1 Then
    ola.LogInfo "keep at most 20 files"
    ' 立即清理可用：LogCleanupOldFiles(logger, -1) 使用上述配置值
End If
text
.局部变量 ola, OLAPlug
.局部变量 ret, 整数型
.局部变量 logger, 长整数型

ola.Create ()
logger ＝ 0

ola.LogSetBaseDirectory (logger, “D:\logs”)
ola.LogSetFileNamePattern (logger, “app_{date}_{index}.log”)
ret ＝ ola.LogSetMaxFiles (logger, 20)  ' 保留 20 个
.如果真 (ret ＝ 1)
    ola.LogInfo (“keep at most 20 files”)
    ' 立即清理可用：LogCleanupOldFiles(logger, -1) 使用上述配置值
.如果真结束
aardio
import OLAPlugServer;
var ola = OLAPlugServer();
var logger = 0;

ola.LogSetBaseDirectory(logger, "D:\\logs");
ola.LogSetFileNamePattern(logger, "app_{date}_{index}.log");
var ret = ola.LogSetMaxFiles(logger, 20); // 保留 20 个
if(ret == 1){
    ola.LogInfo("keep at most 20 files");
    // 立即清理可用：LogCleanupOldFiles(logger, -1) 使用上述配置值
}
text
变量 ola <类型 = OLAPlugServer>
ola = 新建 OLAPlugServer
长整数 logger = 0

ola.LogSetBaseDirectory(logger, "D:\\logs")
ola.LogSetFileNamePattern(logger, "app_{date}_{index}.log")
整数 ret = ola.LogSetMaxFiles(logger, 20)  ' 保留 20 个
如果真 (ret ＝ 1)
{
    ola.LogInfo("keep at most 20 files")
    ' 立即清理可用：LogCleanupOldFiles(logger, -1) 使用上述配置值
}
cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
int64_t logger = 0;

ola.LogSetBaseDirectory(logger, "D:\\logs");
ola.LogSetFileNamePattern(logger, "app_{date}_{index}.log");
int32_t ret = ola.LogSetMaxFiles(logger, 20); // 保留 20 个
if (ret != 1) {
    return;
}
ola.LogInfo("keep at most 20 files");
// 立即清理可用：LogCleanupOldFiles(logger, -1) 使用上述配置值

原生 DLL 调用 ​

cpp
long instance = CreateCOLAPlugInterFace();
long logger = 0;

LogSetBaseDirectory(instance, logger, "D:\\logs");
LogSetFileNamePattern(instance, logger, "app_{date}_{index}.log");
int ret = LogSetMaxFiles(instance, logger, 20);
if (ret != 1) {
    return;
}
LogInfo(instance, "keep at most 20 files");
// LogCleanupOldFiles(instance, logger, -1);
csharp
using System.Runtime.InteropServices;

[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern long CreateCOLAPlugInterFace();
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int LogSetBaseDirectory(long ola, long loggerHandle, string baseDirectory);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int LogSetFileNamePattern(long ola, long loggerHandle, string fileNamePattern);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int LogSetMaxFiles(long ola, long loggerHandle, int maxFiles);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int LogInfo(long ola, string message);

long instance = CreateCOLAPlugInterFace();
long logger = 0;

LogSetBaseDirectory(instance, logger, @"D:\logs");
LogSetFileNamePattern(instance, logger, "app_{date}_{index}.log");
int ret = LogSetMaxFiles(instance, logger, 20);
if (ret != 1) return;
LogInfo(instance, "keep at most 20 files");
python
from ctypes import CDLL, c_int, c_int64

ola = CDLL("OLAPlug_x64.dll")
ola.CreateCOLAPlugInterFace.restype = c_int64
instance = ola.CreateCOLAPlugInterFace()
logger = 0

ola.LogSetBaseDirectory(instance, logger, b"D:\\logs")
ola.LogSetFileNamePattern(instance, logger, b"app_{date}_{index}.log")
ret = ola.LogSetMaxFiles(instance, logger, 20)
if ret != 1:
    raise RuntimeError("LogSetMaxFiles failed")
ola.LogInfo(instance, b"keep at most 20 files")

返回值 ​

返回值说明
1成功。
0失败。

注意事项 ​

项目说明
默认值10个。
超过此数量时超过此数量时，最旧的日志文件会被自动删除。
修改后立即生效修改后立即生效，如果日志系统已初始化，会自动重新初始化。
删除规则按文件修改时间排序，删除最旧的文件。
当前正在使用的日志文件不会被删除当前正在使用的日志文件不会被删除。