69 lines
1.9 KiB
C
69 lines
1.9 KiB
C
/**
|
||
* @file myLog.h
|
||
* @brief 异步日志系统接口（纯 C）
|
||
* @details 提供 INFO/ERROR 两级异步日志，非阻塞写入。
|
||
* 支持控制台彩色输出、文件输出、文件按大小轮转。
|
||
* 首次调用 log_prt 时自动初始化，无需手动 init。
|
||
*/
|
||
|
||
#ifndef _MY_LOG_H_
|
||
#define _MY_LOG_H_
|
||
#include <stdint.h>
|
||
#ifdef __cplusplus
|
||
extern "C"
|
||
{
|
||
#endif
|
||
|
||
/** 日志级别：INFO（普通信息） */
|
||
#define LOG_INFO 0
|
||
/** 日志级别：ERROR（错误信息，控制台红色输出） */
|
||
#define LOG_ERROR 1
|
||
|
||
/**
|
||
* @brief 手动初始化日志系统（可选，log_prt 自动懒初始化）
|
||
* @param dir 日志文件目录路径，传 NULL 则默认 /tmp/logs
|
||
* @return 0 成功
|
||
*/
|
||
int log_init(const char *dir);
|
||
|
||
/**
|
||
* @brief 核心日志打印函数（非阻塞，消息入队列后立即返回）
|
||
* @param level 日志级别 LOG_INFO 或 LOG_ERROR
|
||
* @param file 源文件名（通常传 __FILE__）
|
||
* @param func 函数名（通常传 __FUNCTION__）
|
||
* @param line 行号（通常传 __LINE__）
|
||
* @param fmt printf 风格格式化字符串
|
||
* @param ... 可变参数
|
||
*/
|
||
void log_prt(uint32_t level, const char *file, const char *func,
|
||
uint32_t line, const char *fmt, ...);
|
||
|
||
/** 开启日志文件写入 */
|
||
void log_file_on(void);
|
||
|
||
/** 关闭日志文件写入 */
|
||
void log_file_off(void);
|
||
|
||
/** 开启控制台彩色输出 */
|
||
void log_console_on(void);
|
||
|
||
/** 关闭控制台输出 */
|
||
void log_console_off(void);
|
||
|
||
/** 等待异步队列清空（阻塞直到所有消息写入完成） */
|
||
void log_flush(void);
|
||
|
||
/** 停止工作线程、关闭文件、释放消息池内存 */
|
||
void log_cleanup(void);
|
||
|
||
/** INFO 级别日志宏 */
|
||
#define LOG_I(fmt, ...) log_prt(LOG_INFO, __FILE__, __FUNCTION__, __LINE__, fmt, ##__VA_ARGS__)
|
||
|
||
/** ERROR 级别日志宏 */
|
||
#define LOG_E(fmt, ...) log_prt(LOG_ERROR, __FILE__, __FUNCTION__, __LINE__, fmt, ##__VA_ARGS__)
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
#endif
|