"最常见"却又"最不常用"的三个预编译
1、情景再现
1
#error 与#warning
谈到预编译大家常用的有#if、#else、#ifdef、#ifndef、#endif等等条件编译选项。
然而在我们阅读一些大型的代码或者库的时候，一般都会看到有#error和#warning,可能有些小伙伴一扫而过并没有了解清楚这些预编译指令到底该怎么用，写了很久的代码估计也重来没有敲过他们。
#error / #warning
形式 : #error / #warning message
作用 : 生成一个编译错误事件并停止编译/发出警告信息
注意 : message 可以不需要双引号。
参考demo：
#include
#include
//#define configUART_N 5
#ifndef configUART_N
#error configUART_N must define
// #error "configUART must define"
// #warning "configUART must define"
#endif
#if configUART_N > 4
#error configUART_N must not be less than 4
// #error "configUART_N must not be less than 4"
// #warning "configUART_N must not be less than 4"
#endif
/***************************************
* Fuction: 进行预编译测试
* Author :(最后一个bug)
**************************************/
int main(int argc, char *argv[]) {
printf("公众号；最后一个bug\n");
return 0;
}
输出结果：
编译失败，无法生成可执行文件
上面是放开宏，且使用warning的情况，无其他错误的情况下可以生成可执行文件。
解释一下：
通过上面的测试代码可以了解到，通过配合条件预编译#if等，#error和#warning能够在编译过程中分别以错误和告警的形式提醒开发人员注意相关代码设计问题，从而保证代码正确性。
这样对于发布一些庞大的库代码时，为了让开发人员正确的使用库，这些提示会帮助他更好的移植代码。
那么经常有很多小伙伴编译出来的代码有一大堆warning，总是觉得warning关系不大，然而warning也是分不同类型的，对于一些未使用的变量倒关系不大，其他情况还是要认真对待，最好是做到"0 Error，0 warning".
2
#undef
#undef标识符用于把前面的宏定义名取消，别看这宏用得不多，作用可大着呢，下面我简单举几个例子:
1
局部宏定义
一旦定义了宏，那么该文件中往下所有的代码都可以使用该宏，即使是函数内部，这样导致宏比较混乱，如下面代码:
参考demo：
#include
#include
#define configRatio 10
/***************************************
* Fuction: 获得传感器电压值
* Author :(最后一个bug)
**************************************/
int GetSensorVolt(void)
{
#define configRatio 1
int ret = 0;
ret = configRatio*1024; //比例因子*AD值
return ret;
//#undef configRatio
}
/***************************************
* Fuction: 获得传感器电压值
* Author :(最后一个bug)
**************************************/
int GetSensorCurr(void)
{
#define configRatio 2
int ret = 0;
ret = configRatio*1024; //比例因子*AD值
return ret;
//#undef configRatio
}
/***************************************
* Fuction: 进行预编译测试
* Author :(最后一个bug)
**************************************/
int main(int argc, char *argv[]) {
printf("configRatio = %d\n",configRatio); //报宏未定义
printf("GetSensorVolt = %d\n",GetSensorVolt());
printf("GetSensorCurr = %d\n",GetSensorCurr());
printf("公众号；最后一个bug\n");
return 0;
}输出结果：
解释一下：
假如我们没有注意到函数内部的同名宏定义，当然告警也没管，那么在main函数中使用同名宏定义就可能不是我们期待的最上面的宏定义，造成程序bug。
所以我们可以使用#undef来限制每个宏的作用域，如果每个函数内部都使用了#undef，那么main函数中再使用会报宏没有定义，这样便可以找到问题，当然也可以通过警告了解到。
2
选择接口
通过宏来切换不同的接口供程序使用:
参考demo：
#include
#include
#include
#define DEV_SPI
#include "Drive.h"
#undef DEV_SPI
/***************************************
* Fuction: 进行预编译测试
* Author :(最后一个bug)
**************************************/
int main(int argc, char *argv[]) {
char *strbug = "the last bug" ;
SendData(strbug);
ProcessData(strbug);
printf("公众号；最后一个bug\n");
return 0;
}
#include
#ifdef DEV_UART
#define SendData(s) printf("UART Send:%s\n",s)
#define ProcessData(s) printf("UART Process:%s\n",s)
#endif
#ifdef DEV_CAN
#define SendData(s) printf("CAN Send:%s\n",s)
#define ProcessData(s) printf("CAN Process:%s\n",s)
#endif
#ifdef DEV_SPI
#define SendData(s) printf("Spi Send:%s\n",s)
#define ProcessData(s) printf("Spi Process:%s\n",s)
#endif
输出结果：
3
自定义接口
当多个人维护一套代码的时候，有些同事喜欢调用库函数接口，而有些同事喜欢调用自定义接口，为了方便统一使用自定义接口或者库接口，我们会进行如下操作:
参考demo：
#include
#include
#include
#include "Drive.h"
//#undef printf
/***************************************
* Fuction: 进行预编译测试
* Author :(最后一个bug)
**************************************/
int main(int argc, char *argv[]) {
char *strbug = "the last bug" ;
printf("公众号；最后一个bug\n");
return 0;
}
#ifndef __DRIVE_H__
#define __DRIVE_H__
#define printf printf("please use Kprintf!\n");
extern void Kprintf(char *str);
#endif输出结果：
这样下面的代码你就只能够使用Kprintf来进行输出打印，而当我们放开注释掉的宏，这样就又可以使用printf了，还是比较方便的。
2、结束语
上面这几个比较"冷门"的知识认真想想其实还是挺有用的，可能现在的产品都急于快速上市，对于代码的雕琢还有所欠缺的，一份成熟的代码不仅仅只是稳定，还有后期的维护、扩展等等都是值得考虑的。
-END-
来源 | 最后一个bug
作者 | bug菌
| 整理文章为传播相关技术，版权归原作者所有 |
| 如有侵权，请联系删除 |
【1】知名半导体MCU大厂软件开发C代码规范
【2】工业项目，用MCU还是PLC?
【3】为什么嵌入式工程师会对8位MCU有误解？
【4】RGB 接口和 MCU 接口有什么不一样？
【5】8位微控制器（MCU）的隐形成本
免责声明：本文内容由21ic获得授权后发布，版权归原作者所有，本平台仅提供信息存储服务。文章仅代表作者个人观点，不代表本平台立场，如有问题，请联系我们，谢谢！
下载文档
