建站
咨詢
售后
建站咨詢
新聞中心
這里有您想知道的互聯(lián)網(wǎng)營銷解決方案
如何用printf寫一個自己的日志打印系統(tǒng)？
日志打印的注意事項
在編寫程序后，我們可以隨手在需要的地方加入打印信息，同時需要考慮如下事項：
- 日志輸出是有代價的，特別是在嵌入式系統(tǒng)，或者對執(zhí)行時序要求較高的應(yīng)用場景。因此:
a) 只有在需要的地方加入，不能濫用。
b) 一定要有一個全局的開關(guān)，在不需要或者產(chǎn)品發(fā)布的時候，關(guān)閉輸出，或者降低日志輸出的頻率。
- 日志輸出需要有優(yōu)先級控制，例如：發(fā)生錯誤時的日志優(yōu)先級最高，一般都要輸出；一些重要的提示，優(yōu)先級中等，可能會在debug版的軟件中打開；一些不重要的提示，可能只會在需要的時候（例如跟蹤bug）打開。
- 不要直接使用printf（或者printk）。日志輸出的目標是多樣的，例如通過printf輸出到屏幕、通過串口輸出到串口調(diào)試助手、通過文件操作寫入到文件等等。
要通過重定義的方式，將所有的日志輸出指令定義到合適的輸出路徑，當(dāng)需要修 改輸出路徑的時候，只要修改重定義的部分即可。否則需要在整個代碼中修改， 就麻煩了。
- 最好為每個軟件模塊提供單獨的日志輸出開關(guān)，以增加調(diào)試的靈活性。
- 很多時候，日志輸出語句，可以部分代替代碼注釋的功能。
日志打印的實現(xiàn)
結(jié)合上面的注意事項，我們可以按照如下步驟實現(xiàn)一個小型的日志輸出系統(tǒng)。
- 新建debug.h（如果只是在PC上使用printf，則只需要一個頭文件即可。如果有需要文件或者串口操作，可以在這個基礎(chǔ)上增加debug.c，這里暫時不再描述）
- 定義一個宏開關(guān)，用于控制日志輸出的開關(guān)。
/*
* debug control, you can switch on (delete 'x' suffix)
* to enable log output and assert mechanism
*/
#define CONFIG_ENABLE_DEBUG
- 定義ERR、INFO、DEBUG三個日志級別。
/*
定義ERR、INFO、DEBUG三個日志級別。
/*
* debug level,
* if is DEBUG_LEVEL_DISABLE, no log is allowed output,
* if is DEBUG_LEVEL_ERR, only ERR is allowed output,
* if is DEBUG_LEVEL_INFO, ERR and INFO are allowed output,
* if is DEBUG_LEVEL_DEBUG, all log are allowed output,
- 如果使用系統(tǒng)的printf，需要包含stdio.h，并將printf重定義為PRINT。（無論是Windows還是Linux，皆是如此，如果是嵌入式平臺，可以自定義PRINT接口）
/* it can be change to others, such as file operations */
#include
#define PRINT printf
- 定義一個宏，用于定義日志輸出級別。
/*
* the macro to set debug level, you should call it
* once in the files you need use debug system
*/
#define DEBUG_SET_LEVEL(x) static int debug = x
需要在每一個需要日志輸出的C文件中調(diào)用，如下：
/*
* define the debug level of this file,
* please see 'debug.h' for detail info
*/
DEBUG_SET_LEVEL(DEBUG_LEVEL_ERR);
- 定義ASSERT、ERR、INFO、DEBUG等宏 。
#define ASSERT() \
do { \
PRINT("ASSERT: %s %s %d", \
__FILE__, __FUNCTION__, __LINE__); \
while (1); \
} while (0)
#define ERR(...) \
do { \
if (debug >= DEBUG_LEVEL_ERR) { \
PRINT(__VA_ARGS__); \
} \
} while (0)
…
- 在需要日志輸出的C文件中，包含debug.h，并定義所需的日志級別。就可以在需要的時候輸出日志信息了。
debug_test.c
-----------------------------------------------------
#include "debug.h"
/*
* define the debug level of this file,
* please see 'debug.h' for detail info
*/
DEBUG_SET_LEVEL(DEBUG_LEVEL_ERR);
int main(void) {
ERR("This is a error message\n");
INFO("This is a info message\n");
DEBUG("This is a debug message\n");
ASSERT();
return 0;
}
Step8. 可以根據(jù)需要，修改容許輸出的日志級別。
分享題目：如何用printf寫一個自己的日志打印系統(tǒng)？
文章網(wǎng)址：http://www.5511xx.com/article/cdijigo.html
