注释

2019-01-14

注释


在 Pascal 中,注释括在大括号中或带星号的圆括号中。Delphi 也认可 C++ 风格的注释,即把注释放在双斜线后。例如

{this is a comment}

(* this is another comment *)

// this is a comment up to the end of the line

第一种注释方式较简略,使用也较为普遍;第二种方式在欧洲使用较广 ,因为欧洲的键盘缺少大括号;第三种方式的注释是从 C++ 借用来的,只在 32 位版本的 Delphi 中可用,它在给一行代码加短注释时非常有用。

在这本书中我用斜体表示注释,用粗体表示关键词,以此与默认的 Delphi 语法风格表示一致。

上述三种不同的注释方式有益于进行嵌套注释。例如你要注销一段代码,而代码行中又包含真正的注释行,这时采用同一种注释方式是不对的:

{  ... code
{comment, creating problems}
... code }

正确的方法是插入第二种注释方式:

{  ... code
//this comment is OK
... code }

注意:如果左大括号或圆括号-星号后面跟美元符号($),那么其中的内容就成了编译指令,如 {$X+}。

实际上,编译指令仍是注释。例如,{$X+ This is a comment} 是合法的。这既是有效的编译指令又是一条注释,尽管明智的程序员很可能会注意把编译指令和注释分开。


阅读441