FreeBASIC学习笔记——第09章 预编译

9.1 文件包含

        FreeBASIC文件包含有三个指令:#Include,句包含另一个源文件的内容;#IncLib,包含一个库文件;#libpath,将库搜索路径添加到链接器的搜索路径列表中。

        #Include在其指令出现的位置插入另一个文件的源代码。这具有从所包含的文件编译源代码的效果,就好像它是包含它的源文件的一部分。一旦编译器到达了include文件的末尾,原始源文件就会继续编译。这使得文件可以根据功能分成多个文件,在由多个模块组成的程序中具有声明的单个文件是有用的。您可以在include文件中包含文件,这样可以避免将原始文件包含在其中,只有在编译后才会产生结果。通常,include文件的扩展名为.bi,主要用于声明库的过程或函数或变量,但任何有效的源代码都可能存在于包含的文件中。

       Once说明符告诉编译器只包含该文件一次,即使它被源代码包含多次。元命令$Include是#Include的替代形式,主要是为了兼容QuickBASIC存在的。正常使用建议用#include。

        根据需要,编译器将自动转换路径分隔符('/'和'\'),以正确加载文件。文件名称可以是绝对路径或相对路径。对于相对路径,或根本没有路径,include文件按以下顺序进行搜索:1、相对于源文件的目录;2、相对于当前工作目录;3、相对于使用-i命令行选项指定的添加目;4、FreeBASIC安装的包含文件夹(FreeBASIC\inc),其中FreeBASIC是fbc可执行文件所在的文件夹)

语法:


例如:FireFly默认引用的文件


        #IncLib在链接过程中包含一个库,就像用户在命令行中指定了-l libname一样。FreeBASIC的库文件以.a为后缀,例如:包含一个libmystuff.a的库文件可以用语句#inclib "mystuff" 来实现。
        #libpath将库搜索路径添加到链接器的搜索路径列表中,就像在命令行中使用'-p'选项指定的一样。路径与调用fbc的工作目录相对,而不是相对于源文件的目录。如果路径不存在并且编译和链接将继续,则不会生成错误。例如搜索lib目录下的外部库则使用#libpath “lib”。
9.2 宏定义
        FreeBASIC的宏定义有两种:#Define和#Macro。#Define允许声明基于文本的预处理器宏。一旦编译器看到#Define定义的标识符,则用它body 替换该标识符。body 可以为空。替换是递归完成的,直到没有更多的标识符可以替换,编译器可以继续分析生成的代码。#UnDef用于取消定义先前使用#Define定义的标识符。
        Parameters 将define转换为类似函数的宏,允许将文本参数传递给宏。body 中的任何参数名称的出现将在扩展期间由给定的参数文本替换。
        注意:在类似函数的宏声明中,标识符(Identifier)之后必须是括号“(”,之间不能有任何空格,否则编译器会将其视为body 的一部分。
        如果在模块级别定义,定义在整个模块中是可见的。如果在具有范围(Sub,For..Next,While..Wend,Do..Loop,Scope..End Scope等)的复合语句中定义了标识符 ,则标识符 定义仅在该范围内可见。另一方面,命名空间对define的可见性没有任何影响。可以使用-pp编译器选项检查宏扩展的结果。#Define通常用于声明常量,Const语句则是一种更为安全的声明方法。
语法:


例如:

FreeBASIC学习笔记——第09章 预编译_第1张图片

        #Macro其实就是#Define的多行形式,语法如下:

FreeBASIC学习笔记——第09章 预编译_第2张图片

例如:


9.3 条件编译

        条件编译语句即是有条件的在编译时选择一定的语句参与编译,FreeBASIC的条件编译语句有#if…#elseif…#else…#endif(这里可以是一个整体,也可以单独分开,跟if..else语句的用法相同,只是一个用于编译时,一个用于运行时)defined (symbol_name ) 用来判断给定符号名称是否定义,如果符号已被定义,defined预处理函数将返回真(True)如果符号未知,则返回假(False)。此语句通常配合#if条件语句来判断。

语法:


例如:

FreeBASIC学习笔记——第09章 预编译_第3张图片

        #IfDef和#IfnDef用来判断标识符(symbol)是否定义,必须用#EndIf来结束。通常我们用#IfnDef来判断头文件是否多次引用。

语法:#IfDef


例如:


语法:#ifnDef


例如:


你可能感兴趣的:(FreeBASIC学习笔记,FreeBASIC,include,宏定义,条件编译,预编译)