分隔的評論
註釋以正斜槓開頭,緊接著是星號(/*
),並且一旦遇到星號後緊跟一個正斜槓(*/
)就會結束。這些字元組合之間的所有內容都是註釋,並被編譯器視為空白(基本上被忽略)。
/* 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 => */