之前使用 log4c 或者 log4cpp 的时候, 总需要配置一些文件和链接库之类复杂的配置。 虽然越复杂越说明这个软件支持的功能多、可选择性强, 但是对于一个小的项目,或者要研究他人的代码而加点儿日志的时候, 用这么复杂的配置就没必要了。
所以我就想,要不写个简单一些的日志库, 这样再用到不需要那么复杂的日志控制工具的时候, 就不用每次都配置环境,也不用写配置文件什么的了。 所以我就写了个这个库,因为过于简单,代码也不多, 也就没必要做成lib库,直接编译到代码里就可以了。
下面从一个简单的小例子来认识一下这个库。
这个库包含两个文件,一个是 .c 文件,一个是 .h 文件, 在使用的时候直接和你的项目代码编译到一起就可以了。
假设项目的代码结构如下:
ls easylog.c easylog.h main.c
项目的主要代码在 main.c 文件里面:
cat main.c
#include <stdio.h>
#include "easylog.h" int main(int argc, char* argv[]) {
easylog("hello 我的"); return ;
}
编译:
gcc -o main main.c easylog.c
运行:
$ ./main
$ ls easylog.c easylog.h main main.c main.log
$ cat main.log
hello 我的
上面的例子是最简配置,也就是不增加任何的多余信息, 在 easylog() 函数里面写什么,就输出什么。 还要就是,在什么都不设置的情况下,会自动创建和执行的文件一样的前缀的log文件。 获得这个文件名的方式是通过系统文件 "/proc/self/exe" 获取的。
要是我想换个其它的日志文件名字呢,那就是 那就需要复杂一些的操作需要在代码里面增加一行代码, 使用 easylog_file() 来制定日志文件的名字。 例如我们要把日志放到文件test.log中, 那就可以这么写:
修改项目文件,编译执行,查看日志文件:
$ cat main.c
#include <stdio.h>
#include "easylog.h" int main(int argc, char* argv[]) {
easylog_file("test.log");
easylog("hello 我的"); return ;
} $ gcc -o main main.c easylog.c
$ ./main
$ ls
easylog.c easylog.h main main.c main.log test.log
$ cat test.log
hello 我的
可以看到,当前目录下多了一个 test.log 文件,查看其中的内容,可以看到就是我们输出的日志。
可是我要是想获取其它的信息呢,比如我想获取时间信息。 那就得再加一行,easylog_flag_add(EASYLOG_DATE | EASYLOG_TIME) 这句代码的意思是,在日志中增加两个属性, EASYLOG_DATE 就是日期,EASYLOG_TIME 就是时间。
下面我们修改一下我们的项目文件 main.c,增加一行时间日期的设置代码。
$ cat main.c
#include <stdio.h>
#include "easylog.h" int main(int argc, char* argv[]) {
easylog_file("test.log");
easylog_flag_add(EASYLOG_DATE | EASYLOG_TIME);
easylog("hello 我的"); return ;
}
编译,运行,查看日志:
$ gcc -o main main.c easylog.c
$ ./main
$ cat test.log
hello 我的
-- ::23.847 -- hello 我的
既然是为了日志,那就需要更详细的信息,比如我的这个日志是在哪个文件哪一行写下的呢, 为了得到这些信息,我们可以再加上一些设置,比如 EASYLOG_FILE、 EASYLOG_LINE、EASYLOG_FUNC,这三个分别是在日志中记录下这条日志语句所在的 文件、文件行以及所在的函数名。
修改项目文件,编译,运行,查看日志:
$ cat main.c
#include <stdio.h>
#include "easylog.h" int main(int argc, char* argv[]) {
easylog_file("test.log");//设置日志文件名
easylog_flag_add(EASYLOG_DATE | //设置日志需要的属性
EASYLOG_TIME |
EASYLOG_FILE |
EASYLOG_LINE |
EASYLOG_FUNC);
easylog("hello 我的"); return ;
} $ gcc -o main main.c easylog.c
$ ./main
$ cat test.log
hello 我的
-- ::23.847 -- hello 我的
-- ::38.438 main.c main() -- hello 我的
从日志文件也可以看到,最后一行日志显示了日志所在的文件,行数和函数名。 和它上面的两行形成了鲜明的对比。
如果我们在记录到一半的时候,不想要某一个属性了,怎么办呢? 那就移除某一个属性,比如现在要移除日期属性,那就加这么一行: easylog_flag_rm(EASYLOG_DATE);
修改项目文件,编译,运行,查看日志:
$ cat main.c
#include <stdio.h>
#include "easylog.h" int main(int argc, char* argv[]) {
easylog_file("test.log");
easylog_flag_add(EASYLOG_DATE |
EASYLOG_TIME |
EASYLOG_FILE |
EASYLOG_LINE |
EASYLOG_FUNC);
easylog("hello 我的");
easylog_flag_rm(EASYLOG_DATE);//移除项目属性
easylog("hello 你的"); return ;
} $ gcc -o main main.c easylog.c
$ ./main
$ cat test.log
hello 我的
-- ::28.094 -- hello 我的
-- ::42.996 main.c main() -- hello 我的
::42.997 main.c main() -- hello 你的
从最后的日志中可以看出,日志的最后一行没有记录日期信息。
因为 easylog 的代码本身很少,一共也就200多行, 所以可以被使用者很容易的修改和使用。
最后,easylog 的代码放在了github上,地址在这里https://github.com/fengbohello/easylog ,欢迎同学们来使用 ^_^