在程序中,尤其是一个复杂的程序中,适当加入注释可增加程序的可读性,也有利于程序的修改、调试和交流。注释可出现在程序中任何可出现分隔符的地方,但不能插在一个标识符或关键字之中。注释的内容在程序编译时将会忽略,不产生目标代码,因此,注释部分的有无对程序的执行结果不产生任何影响。
Java有以下3种注释格式:
//single line
称为单行注释格式。所有从“//”开始到行末的字符将被忽略。
/* any section */
称为段注释格式。所有在“/*”和“*/”中的字符将被忽略,这些注释能扩展到多行。
/** any section,used by javadoc to generate HTML documents */
称为Java文档注释格式。所有在/**和*/中的字符都被看作是注释,但是这些注释只应用在声明语句之前,因为它们将被Java文档生成器用于自动建立文档。Java文档注释内部可包括某些HTML标记,如<PRE>和<T1>,但其中不可以包括HTML结构标记,如<H2>和<HR>。
在这3种格式中,前两种与C++的注释格式相同,第三种则是Java语言专门引入的一种注释格式。
空格、逗号、分号及行结束符称为分隔符,规定任意两个相邻标识符、数、保留字或语句之间必须至少有一个分隔符,以便编译程序能识别。为了便于阅读,程序语言如同自然语言一样需要恰当地使用分隔符。值得注意的是,这些分隔符不能互相代用,即该用空格的地方只能用空格,该用逗号的地方只能用逗号。
几个重要的分隔符如下。
· 大括号({ }):用来定义类体、方法体、复合语句和数组的初始化。
· 分号(;):语句结束的标志。
· 逗号(,):用于区分方法的各个参数,区分变量说明的各个变量。
· 冒号(:):用于语句标号。