打印
[软件资料]

C语言开发如何将错误扼杀在编译阶段?

[复制链接]
294|4
手机看帖
扫描二维码
随时随地手机跟帖
跳转到指定楼层
楼主
cr315|  楼主 | 2023-11-22 09:46 | 只看该作者 回帖奖励 |倒序浏览 |阅读模式
你有没有想过,C语言一些简单的语法规则,可以做出很巧妙的方法。

举个例子,C语言的数组长度是不允许是负数的,当然常识中数组长度为负数好像也没什么意义。
例如:int arr[1];是对的,而int arr[-1];是错的。
这个规则很简单,也很容易理解,当然也不会引人关注。
但我说可以用这个语法规则做C语言assert断言错误检查,你信么?
优秀的程序员,一般都是想尽一切办法将程序的错误尽可能地被拦截在运行之前,即编译阶段和预编译阶段的,而不是流出到运行阶段,更不是发生在用户手里的产品中。
对于预编译阶段的错误拦截,比较简单,通过#if和#error等预编译指令就可以做到,例如:
1、FreeRTOS中的Priority检查,用户必须将优先级定义大于或等于1,否则就报错。
#if configMAX_PRIORITIES < 1   
  #error configMAX_PRIORITIES must be defined to be greater than or equal to 1.
#endif
这是因为,程序设计里如果遇到configMAX_PRIORITIES < 1的情况,可能会导致更严重的错误。
所以,这种在预编译阶段拦截了这个错误,是很有作用的。

2、FreeRTOS中的运行时状态获取函数,必须依赖于configUSE_TRACE_FACILITY的定义。

void vTaskGetRunTimeStats( char *pcWriteBuffer )
{
TaskStatus_t *pxTaskStatusArray;
UBaseType_t uxArraySize, x;
uint32_t ulTotalTime, ulStatsAsPercentage;
#if( configUSE_TRACE_FACILITY != 1 )
{
    #error configUSE_TRACE_FACILITY must also be set to 1 in FreeRTOSConfig.h to use vTaskGetRunTimeStats().
}
#endif
因为,这个函数很依赖其他其他的函数实现或者资源定义,那么这个configUSE_TRACE_FACILITY管理了这些。

3、版本检查,如果你设计一个比较通用的功能,可以用到很多项目中去,为了方便管理和迭代更新,就要对这个功能模块做版本定义。那么,不同版本之间就存在差异,可能存在不兼容的情况,此时就可以用预编译指令做这种兼容的检查。
#if (XXX_VER < 0x201)
    #error "This version of XXX is too low!"
#endif
通过预编译指令来检查错误是很有限的,因为预编译指令能检查的是立即数和一些逻辑关系。
于是,我们还要考虑编译阶段的错误检查,即对在编译阶段产生的结果做检查。

例如,unsigned long或者void*的长度检查即sizeof(unsigned long)或sizeof(void*)的值,就必须在编译阶段。

由于unsigned long和void*的长度在不同芯片架构上可能存在差异,如果你的程序依赖这个类型的长度,那必须要检查其长度是否为你设计的那样。

像这种#if sizeof(unsigned long) == 4是不正确的做法,因为预编译无法计算sizeof(unsigned long)。

那么,有没有一种情况能确保sizeof(unsigned long)的值是4才不出错呢?

也许你会想到一个叫assert的东西,例如FreeRTOS里面定义的。

#define configASSERT(x)   if((x)==0) { taskDISABLE_INTERRUPTS(); for( ;; ); }
既可以这样使用configASSERT(sizeof(unsigned long) == 4),如果sizeof(unsigned long) == 4,那么程序是“静悄悄”的,当做啥事都没发生,但是如果sizeof(unsigned long) == 8,那么程序就会进入for( ;; );无法自拔。
但是,这种做法是运行阶段的,必须要在程序已经集成好并让其在实际环境中运行才能发现这种错误,排查起来成本还是有点高。

那么,有没有一种办法可以让其扼杀在编译阶段呢?

答案是有的,像C++11和C11就支持这种assert了,名叫STATIC_ASSERT,需要包含头文件assert.h。

但是,如果我还没用到C11,也想用这种STATIC_ASSERT呢,有没有办法自己实现一个?

答案也是可以的,需要想个窍门,例如从数组的长度入手。

像int arr[1];这种定义是没有问题的,但int arr[-1];却是会引起编译器报错的,我们就可以基于这种东西做文章了,即将数组长度换成检查条件COND,即如果COND为TRUE就不报错,为FALSE就报错。

通过一顿反复尝试,搞成这样或许就可以了。

int arr[(!!(COND))*2-1];
这里(!!(COND))*2-1没有一个符号是多余的,简单解释下:
首先,(COND)这里加了一层括号,防止COND是个比较复杂的表达式,可能引发未知的优先级问题;

第二,(!!(COND))这里有两个感叹号,即逻辑取反再取反。也许你会觉得有点奇怪,!!TRUE不就是TURE吗,!!FALSE也是FALSE啊,双层取反是不是有点多余。那你就要认真思考下TRUE和FALSE的定义了,C语言中的FALSE是0,而非0是TRUE,这个非0就有很多发挥空间了,例如整数100,也是TRUE,但是!!100就会变成1,这里的(!!(COND))就是让其结果变成0或者1,而不是其他数。

第三,通过第二种解释,就很容易理解(!!(COND))*2-1这可以保证这个结果是1或者-1,而不存在其他数值。因为,我们的目的要的是int arr[1];或者int arr[-1];即可。

定义一个数组用在程序中间好像用起来没那么友好,可以换成:

typedef int arr[(!!(COND))*2-1];
为了还能看到多一点点错误信息,还可以将其定义成宏,并带多一个参数,这就成了这样:

#define STATIC_ASSERT(COND,MSG) typedef char static_assertion_##MSG[(!!(COND))*2-1]
在这个基础上再搞定其他的,就可以这样了:

// token pasting madness:
#define COMPILE_TIME_ASSERT3(X,L) STATIC_ASSERT(X,static_assertion_at_line_##L)
#define COMPILE_TIME_ASSERT2(X,L) COMPILE_TIME_ASSERT3(X,L)
#define COMPILE_TIME_ASSERT(X)    COMPILE_TIME_ASSERT2(X,__LINE__)
接着,判断sizeof(unsigned long) 是否为4,就可以这样:

STATIC_ASSERT(sizeof(unsigned long) == 4,unsigned_long_size_is_not_4_error);
好了,今天要分享的内容就这么多,这是不是很好玩?

使用特权

评论回复
沙发
jf101| | 2023-11-22 12:51 | 只看该作者
其实还是准备阶段做好,编译阶段和预编译阶段

使用特权

评论回复
板凳
guijial511| | 2023-11-23 08:01 | 只看该作者
代码走查,静态分析软件。

使用特权

评论回复
地板
cr315|  楼主 | 2023-12-4 09:58 | 只看该作者
使用严格的编译选项,例如在GCC或Clang中使用-Wall,-Werror等选项,可以尽可能地发现并报告所有潜在的错误。
使用静态代码分析工具,如Clang's static analyzer, cppcheck等,可以在编译阶段找出潜在的错误和问题。

使用特权

评论回复
5
forgot| | 2023-12-8 09:06 | 只看该作者
像C++11和C11就支持这种assert了,名叫STATIC_ASSERT,需要包含头文件assert.h

使用特权

评论回复
发新帖 我要提问
您需要登录后才可以回帖 登录 | 注册

本版积分规则

1196

主题

3012

帖子

0

粉丝