C语言#include的用法(containskey)

C语言include的用法(containskey)

C语言include的用法

include 命令是预处理命令的一种，预处理命令可以将别的源代码内容插入到所指定的位置；可以标识出只有在特定条件下才会被编译的某一段程序代码；可以定义类似标识符功能的宏，在编译时，预处理器会用别的文本取代该宏。

插入头文件的内容

有两种方式可以指定插入头文件：

include <文件名>
include "文件名"

如下例所示：

include                // 一些数学函数的原型，以及相关的类型和宏

只要使用 include 命令，这些定义就可被任何源文件使用。如下例所示：

include "myproject.h"         // 用在当前项目中的函数原型、类型定义和宏

你如果使用宏，该宏的取代结果必须确保生成正确的 include 命令。例 1 展示了这样的 include 命令。【例1】在 include 命令中的宏

ifdef        _DEBUG_
  define       MY_HEADER       "myProject_dbg.h"
else
  define       MY_HEADER       "myProject.h"
endif
include        MY_HEADER

当上述程序代码进入预处理时，如果 _DEBUG_ 宏已被定义，那么预处理器会插入 myProject_dbg.h 的内容；如果还没定义，则插入 myProject.h 的内容。

预处理器如何找到头文件

由给定的 C 语言实现版本决定 include 命令所指定文件的搜索路径。同时，也由实现版本决定文件名是否区分大小写。对于命令中使用尖括号指定的文件（<文件名>），预处理器通常会在特定的系统路径下搜索，例如，在 Unix 系统中，会搜索路径 /usr/local/include 与 /usr/include。对于命令中用双引号指定的文件（"文件名"），预处理器通常首先在当前目录下寻找，也就是包含该程序其他源文件的目录。如果在当前目录下没有找到，那么预处理器也会搜索系统的 include 路径。文件名中可以包含路径。但如果文件名中包含了路径，则预处理器只会到该目录下寻找。你也可以通过使用编译器命令行选项，或在环境变量（该变量通常称为 INCLUDE）中加入搜索路径，为 include 命令指定自己的搜索路径。具体的做法请参考采用的编译器的说明文档。

嵌套的 include 命令

include 命令可以嵌套使用；也就是说，因为头文件有时候会包含另一个头文件，很容易发生相同的一个文件被多次包含的情况。例如，假设文件 myProject.h 中包含如下代码：

include 

：

include 
include "myProject.h"

然而，例 2 使用了这个技巧。【例2】避免多次包含

ifndef INCFILE_H_
define INCFILE_H_
/* ...实际的头文件incfile.h的内容写在这里... */
endif  /* INCFILE_H_ */

第一次出现包含 incfile.h 的命令时，INCFILE_H_ 宏是没有定义的。预处理器因此插入 ifndef 和 endif 之间的内容，这段内容包含了对 INCFILE_H_ 宏的定义。嵌入 incfile.h 文件之后，ifndef 条件就会为 false，预处理器会忽略 ifndef 和 endif 之间的内容。