Morn：一个极简的C语言日志

Morn的日志是一个极简的，几乎没有学习成本的日志。它可以实现：

Morn日志相关的接口极简单，只有mLog一个接口用于输出日志。

这个接口简单到几乎可以不去解释。一个简单的例子：

其运行的结果为：

预定义格式

Morn里使用语法糖mLogFormat预设了5种日志格式。以下例说明之：

此程序的输出为：

Morn库所有自带的日志输出（例如定时信息、异常信息），皆采用格式1。

自定义格式

Morn认为：任何的预设格式都未必能满足用户的所有需求，Morn鼓励用户自定义日志格式。

例如，需要在日志格式中输出程序的作者，最简单的方式是：

或

以上两种方法皆可，但过于繁琐，Morn所鼓励的方式是仿照mLogFormat的方式定义日志格式，即：

以下列出了几种可能在自定义格式时可能用到的接口：

此接口返回mLog中所输入的level。为字符串："Debug"，“Info"，"Warning"或"Error"。

详见Morn：时间和日期。在日志中常使用mTimeString(DFLT,NULL)。

返回值为当前线程编号，此编号并非系统中的线程ID，是由1开始递增的整数，如第一个线程返回1，第二个线程返回2等。

对日志属性的设置使用mPropertyWrite接口，向"Log"模块写入属性。日志行为在mPropertyWrite后生效。

设置日志输出等级

属性名为"log_level"。属性为int型整数。

当mLog函数中指定的日志级别大于等于此level_level时，日志才会被输出，否则被忽略。

Morn预设的日志级别由低到高分别是MORN_DEBUG，MORN_INFO，MORN_WARNING，MORN_ERROR，他们的定义分别为：

例如，设置日志输出级别为MORN_WARNING，则程序应如下：

未设置日志级别时，默认日志级别为Info（Release版本）或Debug（Debug版本）。

用户除了可以使用以上四种级别外，还可以自定义日志级别。例如定义一种日志级别为NOTICE，其日志级别高于INFO低于WARNING，则可定义为

一个示例程序如下：

此程序的输出结果如下：

设置日志文件

属性名为"log_file"。属性为字符串。

设置日志文件大小

属性名为"log_filesize"。属性为int型整数，代表文件字节数。

只有设置了"log_file"时此项才有效。若不设置此项，则所有日志将输出到同一文件中（不作分割）。否则日志文件大小超过此值时，将会新建一个新的日志文件。

设置日志的控制台输出

属性名为"log_filesize"。属性为int型布尔值，非0表示使能控制台打印，0表示禁能控制台打印。

未设置此项时，默认使能控制台输出。

以下程序示例了日志的文件和控制台混合输出：

以上：

第一条日志未设置输出方式，默认为控制台输出。

第二条日志设置了输出到文件"./test_log.log"，因此将输出到文件。

第三条日志因设置了结束文件输出，因此将输出到控制台

第四条日志设置了输出到文件"./test_log2.log"，因此将输出到文件。

第五条日志设置了控制台输出使能，因此将同时输出到文件和控制台。

第六条日志因禁能了控制台输出，因此将输出到文件。

第七条日志因设置了结束文件输出，因此将输出到控制台。

因此：在控制台将得到：

在"./test_log.log"文件将得到：

在"./test_log2.log"文件将得到：

自定义日志输出

属性名为"log_function"。属性为void**型指针。

属性名为"log_func_para"。属性为void**型指针。

Morn认为：无论提供多少种日志输出方式都未必能够满足所有的应用场景，最好的办法是允许用户自定义日志的输出方式。

其使用方法如下例：自定义文件通过UDP协议传输到另一台计算机上，云端计算机的IP地址和端口号作为函数参数。

为了测试Morn日志的性能，使用以下程序进行了测试，测试中将Morn日志与常用的glog、spdlog、log4cpp三种日志库进行比较：