你的浏览器版本过低,可能导致网站不能正常访问!
为了你能正常使用网站功能,请使用这些浏览器。

"最常见"三个预编译

[复制链接]
gaosmile 发布时间:2020-10-28 19:20
1、情景再现


咬金,C语言学得怎么样了?
我都敲了2年C代码了,还有我不知道的吗?


你狂,你继续狂!那我问你#error,#warning,#def这三个预编译干啥的?
额~~~,这就尴尬了,平时看代码基本上都见过,没怎么研究过哦。


哈哈~,要不要我教教你呀?
小鲁班,跟大哥说说呗!


行吧,待会说我这队友啥也不懂!
1
#error 与#warning

    谈到预编译大家常用的有#if、#else、#ifdef、#ifndef、#endif等等条件编译选项。
   
    然而在我们阅读一些大型的代码或者库的时候,一般都会看到有#error和#warning,可能有些小伙伴一扫而过并没有了解清楚这些预编译指令到底该怎么用,写了很久的代码估计也重来没有敲过他们。

  • #error / #warning

  • 形式 : #error / #warning message
  • 作用 : 生成一个编译错误事件并停止编译/发出警告信息
  • 注意 : message 可以不需要双引号。


参考demo:
#include <stdio.h>
#include <stdlib.h>

//#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;
}
输出结果:

微信图片_20201028191356.png
  • 编译失败,无法生成可执行文件


微信图片_20201028191400.png
  • 上面是放开宏,且使用warning的情况,无其他错误的情况下可以生成可执行文件。


解释一下:
  • 通过上面的测试代码可以了解到,通过配合条件预编译#if等,#error和#warning能够在编译过程中分别以错误和告警的形式提醒开发人员注意相关代码设计问题,从而保证代码正确性。


  • 这样对于发布一些庞大的库代码时,为了让开发人员正确的使用库,这些提示会帮助他更好的移植代码。


  • 那么经常有很多小伙伴编译出来的代码有一大堆warning,总是觉得warning关系不大,然而warning也是分不同类型的,对于一些未使用的变量倒关系不大,其他情况还是要认真对待,最好是做到"0 Error,0 warning".



2
#undef

   #undef标识符用于把前面的宏定义名取消,别看这宏用得不多,作用可大着呢,下面我简单举几个例子:

1
局部宏定义

    一旦定义了宏,那么该文件中往下所有的代码都可以使用该宏,即使是函数内部,这样导致宏比较混乱,如下面代码:
参考demo:
#include <stdio.h>
#include <stdlib.h>

#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;
}
输出结果:
微信图片_20201028191403.png

微信图片_20201028191407.png
解释一下:
  • 假如我们没有注意到函数内部的同名宏定义,当然告警也没管,那么在main函数中使用同名宏定义就可能不是我们期待的最上面的宏定义,造成程序bug。


  • 所以我们可以使用#undef来限制每个宏的作用域,如果每个函数内部都使用了#undef,那么main函数中再使用会报宏没有定义,这样便可以找到问题,当然也可以通过警告了解到。


2
选择接口

   通过宏来切换不同的接口供程序使用:
参考demo:
#include <stdio.h>
#include <stdlib.h>
#include <string.h>


#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 <stdio.h>


#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
输出结果:

微信图片_20201028191413.png

3
自定义接口

   当多个人维护一套代码的时候,有些同事喜欢调用库函数接口,而有些同事喜欢调用自定义接口,为了方便统一使用自定义接口或者库接口,我们会进行如下操作:
参考demo:
#include <stdio.h>
#include <stdlib.h>
#include <string.h>

#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
输出结果:
微信图片_20201028191416.png

  • 这样下面的代码你就只能够使用Kprintf来进行输出打印,而当我们放开注释掉的宏,这样就又可以使用printf了,还是比较方便的。




咬金,懂了没 ?
小鲁班,这些知识都被你学到了!666

2、结束语
    上面这几个比较"冷门"的知识认真想想其实还是挺有用的,可能现在的产品都急于快速上市,对于代码的雕琢还有所欠缺的,一份成熟的代码不仅仅只是稳定,还有后期的维护、扩展等等都是值得考虑的。

微信图片_20201028191314.png
微信图片_20201028191325.png
微信图片_20201028191322.png
微信图片_20201028191335.png
微信图片_20201028191331.png
微信图片_20201028191340.png
微信图片_20201028191343.png
微信图片_20201028191419.png
微信图片_20201028191424.png
收藏 评论0 发布时间:2020-10-28 19:20

举报

0个回答

所属标签

STM32团队

意法半导体微控制器和微处理器拥有广泛的产品线,包含低成本的8位单片机和基于ARM® Cortex®-M0、M0+、M3、M4、M33、M7及A7内核并具备丰富外设选择的32位微控制器及微处理器


最新内容

关于
我们是谁
投资者关系
意法半导体可持续发展举措
创新与技术
意法半导体官网
联系我们
联系ST分支机构
寻找销售人员和分销渠道
社区
媒体中心
活动与培训
隐私策略
隐私策略
Cookies管理
行使您的权利
官方最新发布
STM32N6 AI生态系统
STM32MCU,MPU高性能GUI
ST ACEPACK电源模块
意法半导体生物传感器
STM32Cube扩展软件包
关注我们
st-img 微信公众号
st-img 手机版