源文件包含

包含另一源文件,到当前源文件中立即在指令下一行的位置。

语法

#include <文件名> (1)
#include "文件名" (2)

解释

文件名 所标识的源文件包含到当前源文件中紧随指令后的一行。

1) 以实现定义行为搜索文件。此语法的意图是搜索实现控制下的文件。典型实现仅搜索标准包含目录。标准 C++ 库和标准 C 库被隐式包含于这些标准包含目录。用户通常能通过编译器选项控制标准包含目录。

2) 以实现定义行为搜索文件。此语法的意图是搜索不在实现控制下的文件。典型实现首先于当前文件所在的目录搜索,然后仅若找不到该文件,才在 (1) 中的标准包含目录搜索。

在找不到文件的情况下,程序为病式。

引用

  • C11 standard (ISO/IEC 9899:2011):
  • 6.10.2 Source file inclusion (p: 164-166)
  • C99 standard (ISO/IEC 9899:1999):
  • 6.10.2 Source file inclusion (p: 149-151)
  • C89/C90 standard (ISO/IEC 9899:1990):
  • 3.8.2 Source file inclusion

参阅

c/header C 标准库头文件列表