#include 指令

预处理器指令,用于在指令出现时将指定文件的内容插入源程序中。

#include“filename
#include <文件名>

参数

描述
filename 要包含的文件的文件名(可选)前面有目录规范。 文件名必须指定现有文件。

备注

#include 指令导致由指定文件的全部内容替换 指令。 预处理器在找到具有指定名称的文件后立即停止搜索;如果为文件指定完整的明确路径规范,则预处理器仅搜索指定的路径。

注意

Effect-Compiler Tool 具有使用 /I 开关的内置包含处理程序。 但是,从 API 执行编译器时,可以通过实现 ID3DXInclude 接口来提供自定义的包含处理程序。

两种语法形式的区别在于未完全指定路径时预处理器搜索头文件的顺序,如下表所示。

语法形式 预处理器搜索模式
#include filename 搜索 include 文件:
  1. 与包含 #include 指令的文件位于同一目录中。
  2. 对于包含 #include 指令的文件,包含 #include 指令的任何文件的目录中。
  3. 在 /I 编译器选项指定的路径中,按它们的列出顺序。
  4. 在由 INCLUDE 环境变量指定的路径中,按它们的列出顺序。

    注意:
    在开发环境中忽略 INCLUDE 环境变量。 有关如何为项目设置包含路径的信息,请参阅开发环境的文档。


#include <文件名> 搜索 include 文件:
  1. 在 /I 编译器选项指定的路径中,按它们的列出顺序。
  2. 在由 INCLUDE 环境变量指定的路径中,按它们的列出顺序。

    注意:
    在开发环境中忽略 INCLUDE 环境变量。 有关如何为项目设置包含路径的信息,请参阅开发环境的文档。


示例

以下示例使预处理器将 #include 指令替换为 stdio.h 的内容。 由于该示例使用尖括号格式,因此预处理器将仅在 /I 编译器选项和 INCLUDE 环境变量列出的目录中搜索文件。

#include <stdio.h>

另请参阅