#INCLUDE

• 来源: https://www.freebasic.net/wiki/wikka.php?wakka=KeyPgInclude
• 最后更新: 2016-03-13

---

用于包含另一个源文件内容的预处理器语句。

语法

#include [once] "file"

描述

#include 在 #include 指令出现的位置插入另一个文件中的源代码。其效果是将包含文件中的源代码作为包含它的源文件的一部分进行编译。一旦编译器到达包含文件的末尾，原始源文件将继续编译。

这对于从文件中移除代码并将其分离到更多文件中非常有用。在由多个模块组成的程序中，将声明放在单个文件中很有用。你可以在包含文件中嵌套包含文件，但要避免将原始文件包含到自身中，这不会产生有效的结果。通常，包含文件的扩展名为 .bi，主要用于声明库的子程序/函数/变量，但包含文件中可以有任何有效的源代码。

once 说明符告诉编译器即使源代码多次包含该文件，也只包含一次。

$Include 是 include 的另一种形式，仅为与 QuickBASIC 兼容而存在。建议改用 #include。

编译器将根据需要自动转换路径分隔符（'/' 和 '\'）以正确加载文件。文件名可以是绝对路径或相对路径。

对于相对路径，或完全未指定路径时，按以下顺序搜索包含文件：

• 相对于源文件所在目录
• 相对于当前工作目录
• 相对于使用 -i 命令行选项指定的附加目录
• FreeBASIC 安装的 include 文件夹（FreeBASIC\inc，其中 FreeBASIC 是 fbc 可执行文件所在的文件夹）

示例

start GeSHi

' header.bi file
Type FooType
    Bar As Byte
    Barbeque As Byte
End Type

end GeSHi

start GeSHi

' main.bas file
#INCLUDE "header.bi"

Dim Foo As FooType

Foo.Bar = 1
Foo.Barbeque = 2

end GeSHi

与 QB 的差异

• FreeBASIC 新增功能

参见

• #define
• #inclib
• 编译器选项: -i
• 编译器选项: -include

返回 目录