2.16 如何指定 include 文件

要包含 C 编译系统提供的任何标准头文件，请使用以下格式：

#include <stdio.h>

尖括号 (<>) 导致预处理程序在系统上头文件的标准位置搜索头文件，此位置通常是 /usr/include 目录。

对于您已存储在您自己的目录中的头文件，格式不同：

#include "header.h"

对于 #include "foo.h" 形式的语句（其中使用了引号），编译器按以下顺序搜索 include 文件：

1. 当前目录（即放置“包含”文件的目录）

2. 以 -I 选项命名的目录（如果有）

3. /usr/include 目录

如果头文件所在的目录与包含该头文件的源文件所在的目录不同，请使用 -I 编译器选项指定存储头文件时所用目录的路径。例如，假设在源文件 mycode.c 中已包含 stdio.h 和 header.h：

#include <stdio.h>
#include "header.h"

进一步假设 header.h 存储在目录 ../defs 中。然后，可能需要使用以下命令：

% cc –I../defs mycode.c

该命令指示预处理程序首先在包含 mycode.c 的目录中搜索 header.h，然后在目录 ../defs 中搜索，最后在标准位置搜索。它还指示预处理程序首先在 ../defs 中搜索 stdio.h，然后在标准位置搜索。不同之处在于：仅对于其名称用引号括起的头文件，才查找当前目录。

您可以在 cc 命令行上多次指定 -I 选项。预处理程序按指定目录出现的顺序查找它们。您可以在同一命令行上对 cc 指定多个选项：

% cc– o prog– I../defs mycode.c

2.16.1 使用 -I- 选项更改搜索算法

-I- 选项提供对缺省搜索规则的更多控制。只有命令行上的第一个 -I- 选项的作用如本节所述。

对于 #include "foo.h" 形式的 include 文件，按以下顺序搜索目录：

1. 使用 -I 选项指定的目录（在 -I- 前后）

2. 编译器提供的 C++ 头文件、ANSI C 头文件和专用文件的目录

3. /usr/include 目录

对于 #include <foo.h> 形式的 include 文件，按以下顺序搜索目录：

1. 使用 -I 选项指定的目录（在 -I- 后面）

2. 编译器提供的 C++ 头文件、ANSI C 头文件和专用文件的目录

3. /usr/include 目录

下例显示在编译 prog.c 时使用 -I- 的结果。

prog.c
#include "a.h"

#include <b.h>

#include "c.h"


c.h
#ifndef _C_H_1

#define _C_H_1

int c1;

#endif


int/a.h
#ifndef _A_H

#define _A_H

#include "c.h"

int a;

#endif


int/b.h
#ifndef _B_H

#define _B_H

#include <c.h>

int b;

#endif
int/c.h
#ifndef _C_H_2

#define _C_H_2

int c2;

#endif

以下命令显示了在当前目录（包含文件的目录）中搜索 #include "foo.h" 形式的包含语句的缺省行为。当处理 inc/a.h 中的 #include "c.h" 语句时，预处理程序包含 inc 子目录中的 c.h 头文件。当处理 prog.c 中的 #include "c.h" 语句时，预处理程序包含具有 prog.c 的目录中的 c.h 文件。请注意，-H 选项指示编译器输出所包含文件的路径。

example% cc -c -Iinc -H prog.c
inc/a.h
            inc/c.h
inc/b.h
            inc/c.h
c.h

以下命令显示了 -I- 选项的效果。当预处理程序处理 #include "foo.h" 形式的语句时，它并不首先在包含目录中查找，而是按照通过 -I 选项指定的目录在命令行上的显示顺序搜索这些目录。处理 inc/a.h 中的 #include "c.h" 语句时，预处理程序包含 ./c.h 头文件，而不是 inc/c.h 头文件。

example% cc -c -I. -I- -Iinc -H prog.c
inc/a.h
            ./c.h
inc/b.h
            inc/c.h
./c.h

2.16.1.1 警告

任何时候都不要将编译器安装区域 /usr/include、/lib 或 /usr/lib 指定为搜索目录。

有关更多信息，请参见B.2.38 -I[-| dir]。