分隔的评论
注释以正斜杠开头,紧接着是星号(/*
),并且一旦遇到星号后紧跟一个正斜杠(*/
)就会结束。这些字符组合之间的所有内容都是注释,并被编译器视为空白(基本上被忽略)。
/* this is a comment */
以上评论是单行评论。这个/*
类型的评论可以跨越多行,如下所示:
/* this is a
multi-line
comment */
虽然它不是绝对必要的,但是多行注释的常见样式约定是在第一行之后的行上放置前导空格和星号,在新行上放置/*
和*/
,这样它们都排成一行:
/*
* this is a
* multi-line
* comment
*/
额外的星号对评论没有任何功能影响,因为它们都没有相关的正斜杠。
这些/*
类型的注释可以在它们自己的行上,代码行的末尾,甚至在代码行中使用:
/* this comment is on its own line */
if (x && y) { /*this comment is at the end of a line */
if ((complexCondition1) /* this comment is within a line of code */
&& (complexCondition2)) {
/* this comment is within an if, on its own line */
}
}
评论不能嵌套。这是因为任何后续的/*
都将被忽略(作为评论的一部分),并且达到的第一个*/
将被视为结束评论。以下示例中的注释不起作用 :
/* outer comment, means this is ignored => /* attempted inner comment */ <= ends the comment, not this one => */