C语言——预编译

C语言——预编译

宗旨：技术的学习是有限的，分享的精神是无限的。

        在C 语言中，并没有任何内在的机制来完成如下一些功能：在编译时包含其他源文件、定义宏、根据条件决定编译时是否包含某些代码。要完成这些工作，就需要使用预处理程序。尽管在目前绝大多数编译器都包含了预处理程序，但通常认为它们是独立于编译器的。预处理过程读入源代码，检查包含预处理指令的语句和宏定义，并对源代码进行响应的转换。预处理过程还会删除程序中的注释和多余的空白字符。

       预处理指令是以#号开头的代码行。#号必须是该行除了任何空白字符外的第一个字符。#后是指令关键字，在关键字和#号之间允许存在任意个数的空白字符。整行语句构成了一条预处理指令，该指令将在编译器进行编译之前对源代码做某些转换。下面是部分预处理指令：

          指令              用途
          #                  空指令，无任何效果
         #include      包含一个源代码文件
         #define        定义宏
         #undef         取消已定义的宏
         #if               如果给定条件为真，则编译下面代码
         #ifdef          如果宏已经定义，则编译下面代码
         #ifndef        如果宏没有定义，则编译下面代码
         #elif         如果前面的#if给定条件不为真，当前条件为真，则编译下面代码
         #endif         结束一个#if……#else条件编译块
         #error        停止编译并显示错误信息

  一、文件包含
        #include预处理指令的作用是在指令处展开被包含的文件。包含可以是多重的，也就是说一个被包含的文件中还可以包含其他文件。标准C编译器至少支持八重嵌套包含。
        预处理过程不检查在转换单元中是否已经包含了某个文件并阻止对它的多次包含。这样就可以在多次包含同一个头文件时，通过给定编译时的条件来达到不同的效果。例如：

        #defineAAA
        #include "t.c"
        #undef AAA
        #include "t.c"

        为了避免那些只能包含一次的头文件被多次包含，可以在头文件中用编译时条件来进行控制。例如：       
        #ifndef_OS_H_
        #define _OS_H_
          ……
        #endif /* _OS_H_ */

        在程序中包含头文件有两种格式：
        ＃include
        ＃include "os.h"
         第一种方法是用尖括号把头文件括起来。这种格式告诉预处理程序在编译器自带的或外部库的头文件中搜索被包含的头文件。第二种方法是用双引号把头文件括起来。这种格式告诉预处理程序在当前被编译的应用程序的源代码文件中搜索被包含的头文件，如果找不到，再搜索编译器自带的头文件。

二、宏
        宏定义了一个代表特定内容的标识符。预处理过程会把源代码中出现的宏标识符替换成宏定义时的值。宏最常见的用法是定义代表某个值的全局符号。宏的第二种用法是定义带参数的宏，这样的宏可以象函数一样被调用，但它是在调用语句处展开宏，并用调用时的实际参数来代替定义中的形式参数。

 1.#define指令
        #define预处理指令是用来定义宏的。该指令最简单的格式是：首先神明一个标识符，然后给出这个标识符代表的代码。在后面的源代码中，就用这些代码来替代该标识符。
宏表示的值可以是一个常量表达式，其中允许包括前面已经定义的宏标识符。例如：
       #define ONE 1
       #define TWO 2
       #define THREE (ONE+TWO)
        注意上面的宏定义使用了括号。尽管它们并不是必须的。但出于谨慎考虑，还是应该加上括号的。

 

2.#运算符
        出现在宏定义中的#运算符把跟在其后的参数转换成一个字符串。有时把这种用法的#称为字符串化运算符。例如：

#definePASTE(n) "adhfkj"#n

int main(void)
{
  printf("%s\n", PASTE(15));

  return 0;
}

        宏定义中的#运算符告诉预处理程序，把源代码中任何传递给该宏的参数转换成一个字符串。所以输出应该是adhfkj15。

3.##运算符
        ##运算符用于把参数连接到一起。预处理程序把出现在##两侧的参数合并成一个符号。看下面的例子：

#defineNUM(a,b,c) a##b##c
#defineSTR(a,b,c) a##b##c

int main(void)
{
  printf("%d\n", NUM(1, 2, 3));
  printf("%s\n", STR("aa", "bb", "cc"));

  return 0;
}
//最后程序的输出为:     
	123    
	aabbcc

 

三、条件编译指令
    条件编译指令将决定那些代码被编译，而哪些是不被编译的。可以根据表达式的值或者某个特定的宏是否被定义来确定编译条件。
1.#if指令
        #if指令检测跟在制造另关键字后的常量表达式。如果表达式为真，则编译后面的代码，知道出现#else、#elif或#endif为止；否则就不编译。

        如果要屏蔽一段代码，建议使用 [ #if 0 ...  #endif ]

2.#endif指令
        #endif用于终止#if预处理指令。

#define DEBUG 0
int main(void)
{
#if DEBUG
  printf("Debugging\n");
#endif
  printf("Running\n");

  return 0;
}

        由于程序定义DEBUG宏代表0，所以#if条件为假，不编译后面的代码直到#endif，所以程序直接输出Running。
        如果去掉#define语句，效果是一样的。

 

3.#ifdef和#ifndef

#define DEBUG

int main(void)
{
#ifdef DEBUG
  printf("yes\n");
#endif
#ifndef DEBUG
  printf("no\n");
#endif

  return 0;
}

        #if defined等价于#ifdef; #if !defined等价于#ifndef

4.#else指令
        #else指令用于某个#if指令之后，当前面的#if指令的条件不为真时，就编译#else后面的代码。#endif指令将中指上面的条件块。

#define DEBUG

int main(void)
{
#ifdef DEBUG
  printf("Debugging\n");
#else
  printf("Notdebugging\n");
#endif
  printf("Running\n");

  return 0;
}

5.#elif指令
        #elif预处理指令综合了#else和#if指令的作用。

#define TWO

int main(void)
{
#ifdef ONE
  printf("1\n");
#elif defined TWO
  printf("2\n");
#else
  printf("3\n");
#endif

  return 0;
}

        程序很好理解，最后输出结果是2。

 6.其他一些标准指令
        #error指令将使编译器显示一条错误信息，然后停止编译。
        #line指令可以改变编译器用来指出警告和错误信息的文件号和行号。
        #pragma指令没有正式的定义。编译器可以自定义其用途。典型的用法是禁止或允许某些烦人的警告信息。

#ifndef _OPTION_H_
#define _OPTION_H_

typedef enum
{
  OPTION_DEV_ID           = 0,
  OPTION_SERVER_IP        = 1,
  OPTION_SMALL_IMAGE_PORT = 2,
  OPTION_LARGE_IMAGE_PORT = 3,
  OPTION_GPS_PORT         = 4,
  OPTION_SERVER_NAME      = 5,
} option_id_t;

typedef __packed union
{
  uint8_tdev_id[SETTING_DEV_ID_MAX_LENGTH];     //设备号
  char server_name[SETTING_SERVER_NAME_MAX_LENGTH];
} option_data_t;

typedef __packed struct
{
  uint8_t id;
  uint8_t length;
  option_data_t data;
} option_item_t;

void OptionInit(void);

#endif /* _OPTION_H_ */