Comments
 
注释是编译器将忽略的文本区域,但可能包含对程序员有用的信息。一些例外是可能出现在某些类型的评论中的元命令。

单行评论

单引号(')可用于指示注释,并可能在源行上的其他关键字后显示。声明的其余部分将被视为评论。
' 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



参考