打印调试
针对常用的调试手段之一——打印调试，设计此打印调试模块，可实现精确定位，Release版很容易去除。
1 /** 2 \file utilDebug.h 3 \brief 调试工具 4 \details 代码中嵌入该测试模块,可针对打印调试实现精确定位 5 */ 6 #ifndef _UTIL_DEBUG_2013_01_08_H_ 7 #define _UTIL_DEBUG_2013_01_08_H_ 8 9 #if defined(__cplusplus) 10 extern "C" 11 { 12 #endif 13 14 #ifndef UTIL_DEBUG 15 #define UTIL_DEBUG /**< release版请注释该行并重新编译所有相关工程*/ 16 #endif 17 18 #ifdef UTIL_DEBUG 19 /**< 打印调试*/ 20 #include <stdio.h> 21 22 /** 23 \brief 打印的调试版本 24 */ 25 #define DEBUG_PRINT(str, ...) do {\ 26 printf(str, ##__VA_ARGS__);\ 27 } while (0); 28 29 /** 30 \brief 默认错误打印 31 \details 仅打印错误所在文件名、函数名及代码行 32 */ 33 #define DEBUG_ERROR_DEFAULT() do {\ 34 printf("file: %s, fun: %s, line: %d\n", __FILE__, __FUNCTION__, __LINE__);\ 35 }while (0) 36 37 /** 38 \brief 错误码打印 39 \details 在默认错误打印的基础上增加错误码的打印 40 41 \param[in] code 错误码(整形) 42 */ 43 #define DEBUG_ERROR_CODE(code) do {\ 44 printf("file: %s, fun: %s, line: %d, code: 0x%x.\n", __FILE__, __FUNCTION__, __LINE__, code);\ 45 }while (0) 46 47 /** 48 \brief 错误原因打印 49 \details 在默认错误打印的基础上增加错误原因的打印 50 51 \param[in] str 错误原因(字符串) 52 */ 53 #define DEBUG_ERROR_REASON(str) do {\ 54 printf("file: %s, fun: %s, line: %d, reason: %s.\n", __FILE__, __FUNCTION__, __LINE__, str);\ 55 }while (0) 56 57 /** 58 \brief 错误码及错误原因打印 59 \details 在默认错误打印的基础上增加错误码和错误原因的打印 60 61 \param[in] code 错误码(整形) 62 \param[in] str 错误原因(字符串) 63 */ 64 #define DEBUG_ERROR_CR(code, str) do {\ 65 printf("file: %s, fun: %s, line: %d, code: 0x%x, reason: %s.\n", __FILE__, __FUNCTION__, __LINE__, code, str);\ 66 }while (0) 67 68 69 /* 断言调试 */ 70 #include <assert.h> 71 /** 72 \brief 断言的调试版本 73 */ 74 #define DEBUG_ASSERT(exp) do {\ 75 assert(exp);\ 76 } while (0) 77 78 #else 79 80 #define DEBUG_PRINT(str, ...) 81 82 #define DEBUG_ERROR_DEFAULT() 83 84 #define DEBUG_ERROR_CODE(code) 85 86 #define DEBUG_ERROR_REASON(str) 87 88 #define DEBUG_ERROR_CR(code, str) 89 90 #define DEBUG_ASSERT(exp) 91 92 #endif 93 94 #if defined(__cplusplus) 95 } 96 #endif 97 #endif/**< _UTIL_DEBUG_2013_01_08_H_*/
