CPP Info Memo part3

CPP Info Memo part3

Table of Contents

• 1 Overview
• 2 Header Files
  • 2.1 Include 语法
  • 2.2 Include 操作
    • 2.2.1 头文件的展开
    • 2.2.2 Files that can be included
  • 2.3 搜索路径
    • 2.3.1 默认路径
    • 2.3.2 路径的修改

1 Overview

 

2 Header Files

C 里面有很多声明和宏定义是专门用来在多个源文件(source file)中共享的， 这些东西被放在专门的文件中，即传说中的头文件(Header file)。 我们可以通过 #include 来通知 preprocessor 来把他们 include 进来。

include 一个头文件，实际上和把这个头文件的内容拷贝进源文件是等效的。 但拷贝操作耗时，且一旦一个头文件稍作修改，所有源文件都要随之变化。 而 include 则解决了这个问题。

2.1 Include 语法

include 有两个用法，即

#include <FILE>

#include "FILE"

区别在于：

• #include <FILE>
  该用法用于 include 系统提供的头文件。 它从标准的系统搜索路径中去寻找指定的头文件。 GCC 中，我们可以通过 -I 来将某个目录添加到搜索路径中去。

• #Include "FILE"
  该用法用来 include 用户自己的头文件。 它先从当前路径下搜索，随后去所谓的引用目录(quoted directory)去找， 最后去系统的标准搜索路径中去找。 引用目录可以通过 -iquote 选项来指定。

无论哪种形式，include 后面的参数在预编译的时候都会被当作字符串常量一样来看待。 其中的*/、/* 不会被当成注释，其中的宏也不会被展开，连 "\" 也不会被看作是转义字符。

2.2 Include 操作

 

2.2.1 头文件的展开

如果一个源文件中包涵了 include 指令， include 指令会让 preprocessor 扫描指定的头文件， 并将源文件其他的内容添加到扫描的输出后面。

例如下面的这个例子：

// Contents in header.h

char *test (void);

// Contents in test.c

int x;
#include "header.h"

int
main (void)
{
    puts (test ());
}

上面代码中有两个文件： header.h 和 test.c ， 则经过预编译后，会变成：

int x;
char *test (void);

int
main (void)
{
  puts (test ());
}

2.2.2 Files that can be included

可以被用来作为 include 的参数的，不只是头文件， 任何包含了 C 程序的片段的文件都可以——只要被包含的文件包含有完整的 tokens 。

因此，Teacher Tan 在他的书中教给学生去 include 一个源文件，也没什么错， 只是这么做不值得推荐而已。 被包含的头文件中，最好是仅有完整的语法单元： 函数声明或者定义、类型声明等等。

2.3 搜索路径

 

2.3.1 默认路径

GCC 会在多个不同的目录下搜索头文件，例如我的机器上用 CEDET 查到的编译 C++ 时候的搜索路径如下：

(semantic-gcc-get-include-paths "c++")

("/usr/lib/gcc/x86_64-pc-linux-gnu/4.5.3/include/g++-v4"
 "/usr/lib/gcc/x86_64-pc-linux-gnu/4.5.3/include/g++-v4/x86_64-pc-linux-gnu"
 "/usr/lib/gcc/x86_64-pc-linux-gnu/4.5.3/include/g++-v4/backward"
 "/usr/lib/gcc/x86_64-pc-linux-gnu/4.5.3/include"
 "/usr/lib/gcc/x86_64-pc-linux-gnu/4.5.3/include-fixed"
 "/usr/include")

2.3.2 路径的修改

我们可以通过选项来修改搜索路径：

• "-I"
  

  该选项用来向这个路径中添加搜索路径，自行添加的路径将会被放到搜索路径的最前端。

• "-nostdinc"
  

  该选项用于禁止 GCC 去默认搜索路径中搜索文件，例如编译内核时会用到该选项， Linux 内核中相关的部分 Makefile 如下：

  NOSTDINC_FLAGS += -nostdinc -isystem $(shell $(CC) -print-file-name=include)
  CHECKFLAGS     += $(NOSTDINC_FLAGS)
  

  但是，通过 "-I" 选项向其中添加的路径不会被禁止。

• "-iquote"
  

  该选项用于在使用

  #inclde "FILE"
  

  这种形式时候添加搜索路径。