在 C 语言中,条件编译指令可以实现源代码的部分编译功能,可以根据表达式的值或者某个特定的宏来确定编译条件,以决定编译哪些代码,不编译哪些。

使用“#ifndef/#define/#endif”防止头文件被重复引用

在 C 语言中,一个文件中可以包含多个头文件,而头文件之间又是可以相互引用的,这将引起一个文件中可能间接多次包含某个头文件,从而导致了某些头文件被重复引用多次。

例如,有 3 个文件 a.h、b.h 和 c.h,其中 b 文件中包含了 a.h,而 c 文件中又分别包含了 a.h 和 b.h 两个文件。于是问题出来了,由于嵌套包含文件的原因,头文件 a.h 被两次包含在源文件 c 中。在这里,如果头文件中没有防止多次编译的语句,有可能会引起如下两种后果:

  • 某些头文件重复引用只是增加了编译器编译的工作量,导致编译效率降低,不会引起太大的问题。但是,这里还需要说明的是,对比较大的工程而言,编译效率低下也将是一件非常痛苦的事情。
  • 某些头文件重复引用,有可能会引起意想不到的严重错误。比如,在头文件中定义了全局变量(虽然这种方式不被推荐,但有时候确实需要这么做),将会导致全局变量被重复定义。

在 C 语言中,避免同一个头文件被多次包含、重复引用,最常用也是最简单的方法就是利用“#ifndef/#define/#endif”结构产生预处理块来防止头文件被重复引用。如下面的示例代码所示:

#ifndef __HEADERNAME_H__
#define __HEADERNAME_H__
/*声明、定义语句*/
#endif

在上面的预处理块中,当第一次引用(include)头文件时,由于“HEADERNAME_H”还没有被宏定义(define)过,即满足“#ifndef__HEADERNAME_H__”,从而执行“#define__HEADERNAME_H__”以及其他内容。

如果因为编码者的不小心或者嵌套包含等原因造成了这个头文件被多次引用(include),那么“#ifndef__HEADERNAME_H__”判断条件将在第二次引用(include)头文件时得不到满足,因此不执行后面的内容,直接跳到“#endif”。

通过“#ifndef/#define/#endif”结构产生预处理块,虽然能够避免同一个头文件被多次包含和重复引用,但也存在一个致命的缺点,那就是一旦一不小心在不同头文件中定义了相同的宏名,问题就比较麻烦了。比如,可能会导致明明看到存在头文件,而编译器却硬说找不到声明等问题。为了避免这种情况,保证宏名的唯一性,建议按照 Google 公司的建议,头文件基于其所在项目源代码树的全路径进行命名。命名格式为:

<PROJECT>_<PATH>_<FILE>_H_

其中,PROJECT 表示项目名称,PATH 表示头文件相对路径,FILE 表示文件名,再以“H”作为后缀。比如,在项目 CashRegister 中,现在该项目所在目录下的一个名为 xml 的子文件夹下的一个 parser 头文件,则宏定义如下:

#ifndef CASHREGISTER_XML_PARSER_H_
#define CASHREGISTER_XML_PARSER_H_
/*声明、定义语句*/
#endif

当然,基于命名习惯原因,也可以这样来写:

#ifndef _CASHREGISTER_XML_PARSER_H_
#define _CASHREGISTER_XML_PARSER_H_
/*声明、定义语句*/
#endif

这里需要注意的是,由于编译器在每次编译时都需要打开头文件才能判定是否有重复定义,因此在编译大型项目时,“#ifndef”会使编译时间相对较长。

除此之外,你还可以使用“#pragma once”方式来防止头文件被重复引用,该方式一般由编译器提供,可以保证同一个文件不会被包含多次。但这里需要特别说明的是,该方式受编译器的限制,有些编译器并不支持该指令,因此在兼容性方面表现得不是很好。这里建议为了代码的兼容性,宁肯降低一些编译性能,还是使用“#ifndef/#define/#endif”结构。
使用条件编译指令实现源代码的部分编译
前面已经说过,条件编译指令可以使编译器按不同的条件编译不同的程序部分,因而产生不同的目标代码文件。这对于程序的移植和调试是很有用的,尤其是针对于跨平台程序移植的时候。在 C 语言中,主要有如下条件编译指令。
1、#if指令
该指令检测表达式值是否为真。如果表达式的值为真,则编译后面的代码直到出现 #else、#elif 或 #endif 为止,否则不编译。
2、#endif指令
该指令用于终止 #if 指令。
3、#else指令
该指令用于 #if 指令之后,当前面的 #if 指令的条件不为真时,就编译 #else 后面的代码。
4、#elif指令
该指令综合了 #else 和 #if 指令的作用。下面的示例代码演示了 #if、#else、#elif 与 #endif 的组合使用情况。

#if OS==1printf("V1.0");
#elif OS==2printf("V2.0");
#elseprintf("未知");
#endif

5、#ifdef 和 #ifndef 指令
相对于 #if 指令(检测表达式的值是否为真),#ifdef 和 #ifndef 指令用于检测指令关键字后面的宏名称是否已经定义。其中,#ifdef 指令表示如果宏已经被定义,那么它的检测结果为真,否则返回假;而 #ifndef 指令的含义正好与 #ifdef 指令相反,它表示如果宏未被定义,那么它的检测结果为真,否则为假。

在一般情况下,条件编译指令组合主要有如下几种形式。

  1. 第一种形式如下:

    #ifdef 宏名称
    /程序段1/
    #else
    /程序段2/
    #endif

它表示如果宏名称已经定义,则对程序段 1 进行编译;否则对程序段 2 进行编译。如果没有程序段 2,则可以省略“#else”,如下所示:

#ifdef 宏名称/*程序段1*/
#endif
  1. 第二种形式如下:

    #ifndef 宏名称
    /程序段1/
    #else
    /程序段2/
    #endif

#ifndef 指令的含义正好与 #ifdef 指令相反,因此它表示如果宏名称未被定义,则对程序段 1 进行编译,否则对程序段 2 进行编译。

  1. 第三种形式如下:

    #if 表达式
    /程序段1/
    #else
    /程序段2/
    #endif

它表示如果表达式的值为真(非 0),则对程序段 1 进行编译,否则对程序段 2 进行编译。如果有多个(两个以上)条件,则可以用 #elif 指令,如下所示:

#if 表达式/*程序段1*/
#elif 表达式/*程序段2*/
#elif 表达式/*程序段3*/
#else/*程序段4*/
#endif

妙用“defined”
在 C 语言中,除了“#ifdef”和“#ifndef”指令之外,还可以使用 defined 判断标识符是否定义过。实际上,“#if defined”等价于“#ifdef”,而“#if!defined”等价于“#ifndef”。例如,下面的示例代码就演示了如何使用 defined 来避免重复包含头文件引起的重复定义问题:

#if !defined(_CASHREGISTER_XML_PARSER_H_)
#define _CASHREGISTER_XML_PARSER_H_
/*声明、定义语句*/
#endif

它实际上等价于下面的代码:

#ifndef _CASHREGISTER_XML_PARSER_H_
#define _CASHREGISTER_XML_PARSER_H_
/*声明、定义语句*/
#endif

当然,从上面的示例来看,或许看不出来使用 defined 有任何的优势。但是,在处理双重和多重判断时,defined 的优势就显现出来了,如下面的代码所示:

#ifndef _CASHREGISTER_XML_PARSER_H_
#ifndef _CASHREGISTER_XML_TRANSFORM_H_
#ifndef _CASHREGISTER_XML_DECODE_H_
/************/
#endif
#endif
#endif

从上面的代码中可以看出,使用“#ifdef”和“#ifndef”指令一次只能同时检测一个宏是否定义。如果需要检测多个宏,则需将“#ifdef”和“#ifndef”指令重复复制多次,这样看起来很不友好。但是,如果这里使用 defined,那就简单多了,如下面的代码所示:

#if !defined(_CASHREGISTER_XML_PARSER_H_)&&!defined(_CASHREGISTER_XML_TRANSFORM_H_)&&!defined(_CASHREGISTER_XML_DECODE_H_)
/************/
#endif

其实,defined 的使用是非常普及的,在一些常见的 C 语言标准库中也随处可见,例如:

    #if (!defined __STRICT_ANSI__ && !defined _ISOC99_SOURCE && \!defined _POSIX_SOURCE && !defined _POSIX_C_SOURCE && \!defined _XOPEN_SOURCE && !defined _BSD_SOURCE && \!defined _SVID_SOURCE)# define _BSD_SOURCE    1# define _SVID_SOURCE    1
#endif

因此,这里建议使用 defined。因为即使当前代码使用的是简单的条件编译,以后在维护或升级时也可能会增加,这样也可以提高程序的可维护性。

原文:https://www.jianshu.com/p/5bd83b35cd38

条件编译指令(符号),C语言条件编译指令完全攻略相关推荐

  1. 小学生计算机清除键是mc,我的世界一键清除指令 | 手游网游页游攻略大全

    发布时间:2015-11-19 我的世界命令方块指令大全 我的世界命令方块怎么用.我的世界命令方块都有哪些攻能?我的世界命令方块怎么使用?下面99单机网小编给大家带来我的世界命令方块指令大全. /gi ...

  2. rust新版组队指令_rust新版除草指令 | 手游网游页游攻略大全

    发布时间:2016-02-11 作为一款在线高自由度游戏,RUST给玩家带来了非常不错的体验,不过随着外挂现象的增加,也渐渐打消了大部分玩家的游戏兴趣,对于高自由度游戏爱好者来说,这款作品还是非常值得 ...

  3. 怎么和steam好友玩rust_rust怎么加好友指令 | 手游网游页游攻略大全

    发布时间:2016-02-11 作为一款在线高自由度游戏,RUST给玩家带来了非常不错的体验,不过随着外挂现象的增加,也渐渐打消了大部分玩家的游戏兴趣,对于高自由度游戏爱好者来说,这款作品还是非常值得 ...

  4. C语言assert函数完全攻略

    断言assert函数,C语言assert函数完全攻略 对于断言,相信大家都不陌生,大多数编程语言也都有断言这一特性.简单地讲,断言就是对某种假设条件进行检查.在 C 语言中,断言被定义为宏的形式(as ...

  5. c语言编译预处理指令大全,C语言预处理指令

    「今天是学习C语言第 32 天」 当你选择了一种语言,意味着你还选择了一组技术.一个社区.--Joshua Bloch # 预处理 C语言源程序先经过预处理器进行预处理,之后经过编译器编译成二进制可执 ...

  6. c语言条件编译的例子,C语言条件编译分析实例

    C语言条件编译分析实例 1.利用#ifdef / #endif 将程序功能模块包括进去,以向某用户提供该功能. 在程序首部定义#define HNLD: #ifdef HNLD include&quo ...

  7. 未转变者空投指令服务器,未转变者空投指令 | 手游网游页游攻略大全

    发布时间:2015-12-02 注意事项:(强烈推荐优先看一下) 1:难度为中等(有不全的地方,还请各位请见谅) 2:在本攻略中,"对空轻战车"指的是机枪式的那种战车." ...

  8. 我的世界服务器为什么显示崩溃,我的世界服务器崩溃的指令 | 手游网游页游攻略大全...

    发布时间:2015-10-01 我的世界游戏中玩家可以使用服务器指令来获取和给予权限,轻而易举完成一般玩家做不到的事,非常便利.那么我的世界有哪些服务器指令呢?下面99单机网小编就来汇总我的世界服务器 ...

  9. 我的世界服务器淬炼系统,我的世界淬炼指令 | 手游网游页游攻略大全

    发布时间:2015-10-01 我的世界游戏中玩家可以使用服务器指令来获取和给予权限,轻而易举完成一般玩家做不到的事,非常便利.那么我的世界有哪些服务器指令呢?下面99单机网小编就来汇总我的世界服务器 ...

  10. 我的世界服务器指令修复耐久,我的世界修改装备耐久度指令 | 手游网游页游攻略大全...

    发布时间:2017-05-05 我的世界火焰蔓延无伤害了 教你怎修改火焰蔓延指令.那下面的这个攻略则是可以将我的世界里面的火焰蔓延效果造成的伤害忽视掉,那到底是一个盛宴的方法,可以让我们避免受火焰蔓延 ...

最新文章

  1. redis3.2集群搭建
  2. AttributeError: module ‘tensorflow‘ has no attribute ‘app‘
  3. html点击后按钮本身文字变化,javascript实现点击后变换按钮显示文字的方法
  4. centos系统设置局域网静态IP
  5. 我看ITIL在中国(六):如何建立有中国特色的IT运维管理平台【二】
  6. 一个基于Node.js的本地快速测试服务器 1
  7. python第三方库安装(复习)
  8. 苹果公司发布TestFlight Groups,放宽二进制版本提交限制
  9. ef core 批量update 非id_Entity Framework (EF) Core
  10. 直播APP系统源码,直播系统源码 直播系统源码
  11. md 文件编辑 Markdown 使用教程
  12. mysql adodb_指南从MySQL转向ADODB的方法_MySQL
  13. 汇新杯选手专访:旅游看人海?VR+旅游让你身临其境
  14. 微信公众号开发-取得AccessToken
  15. 苹果登陆qq邮箱服务器,iPad和iPhone如何登陆QQ邮箱 怎么设置
  16. 苹果充电器怎么辨别真假_airpods怎么辨别真假?
  17. 苏宁0元撸货福利来了!只限新人!老用户放弃吧!便宜只能占一次
  18. web前端框架——一些简单理解
  19. 一个3D打印机挤出装置故障处置实例
  20. torch.squeeze和torch.unsqueeze

热门文章

  1. (嵌入式软件)记2022届应届毕业生试用1个月被劝退的日常
  2. B - Glider Gym - 101911B (贪心)
  3. 计数器视图控件(数字变化效果)
  4. 使用方式一 实现电影院买票 并且存在问题
  5. 插件记录-dplayer直播插件
  6. 解决Failure to find org.glassfish:javax.el:pom:3.0.1-b06-SNAPSHOT
  7. 安卓自定义日历选择器
  8. 脉脉电脑版 v3.0.3 官方版
  9. xadmin开发后台管理系统常见问题
  10. 简单操作一键快速合并视频