注释是编译器将忽略的文本区域,但可能包含对程序员有用的信息。一些例外是可能出现在某些类型的评论中的元命令。
单行评论
单引号(
')可用于指示注释,并可能在源行上的其他关键字后显示。声明的其余部分将被视为评论。
' comment text
评论声明:Rem
以
Rem开头的源代码语句表示该行的其余部分是注释,不会被编译。
Rem行为与上述相同,除了它必须是语句中的第一个关键字。
Rem comment
多行评论
多行注释用标记
/'和
'/标记。两个标记之间的所有文本都被认为是注释文本,没有被编译。
多行注释可以跨越几行,也可以在语句中间使用。评论结束后,声明将继续被解析为正常(即使评论超过换行符)。
/' Multi-line
comment '/
Print "Hello" /' embedded comment'/ " world"
注意:如果FreeBASIC在不在多行注释中遇到密切注释标记,则由于单引号,它会将其视为正常的单行注释。
嵌套评论
多行注释可以包含其中的其他多行注释。每个内部评论都有自己的开放和关闭评论标记。
/'
This is a comment.
/'
This is a comment inside a comment
'/
This Is a comment.
'/
多行注释可以包含无限级别的嵌套注释。FreeBASIC将继续解析更多标记的多行注释,直到关闭评论标记的数量达到开放评论标记的数量,即当它已经关闭了它已经打开的所有评论。
评论后续行
多行语句中的行连续字符(
_)之后可能会出现单行注释。FreeBASIC不解析行继续字符后的文本,所以你不能在它们之后打开多行注释。
Print _ ' line
"This is part of the previous line's statement"
元命令
编译器语句s,如
$Static和
$Include,可以放在单行注释中。
$标志和关键字必须是语句中的前两项,不包括空格。
Rem compile With -lang fblite Or qb
#lang "fblite"
Rem $Static
' $include: 'vbcompat.bi'
单行注释解析
当您进行单行评论时,FreeBASIC将解析该评论,以检查一个编译器语句。如果它发现多行注释,它会像往常一样对待它,并在close-comment标记之后继续解析单行注释。
如果要阻止FreeBASIC解析单行注释,请在注释开头放置另一个单引号(
')。FreeBASIC将将其余的线条(包括多行注释标记和元命令)作为普通文本处理,并将忽略它。评论中遇到的其他单词也会停止解析。
- Note: As of version 0.21.0, this will not longer apply in the -lang fb dialect, and multi-line comment markers will be completely ignored inside single-line comments
'' $static <-- will not get parsed
'' this multiline comment marker ("/'") will be ignored
Print "This line is not a comment."
例子
/'这是一条多线
评论为标题
this example '/
Rem This Is a Single Line comment
'这是一个单行评论
Dim a As Integer '发表评论
Dim b As /' can comment in here also '/ Integer
#if 0
before version 0.16, This was the
only way of commenting Out sections
With multiple lines of code.
#endif
参考