## 注釋
注釋文本無論在哪種語言中都尤為重要。你可以用它來向其他人說明你代碼的用意,也可以用來給自己做提醒。
注釋在代碼運行時不會被執行。
注釋方法是`/* */`或者`//`。
使用`/* */`注釋的語法是這樣的:
>[info] /* 我是注釋 */
你可以跨行注釋:
>[info] /* 我是第一行注釋
>我是第二行注釋
>我是第三行注釋 */
你也可以使用`//`注釋。**一行內**`//`后面的字符都會視為注釋:
>[info] {"你好","你也好"} //我是注釋
>[danger] **注意!** 請不要把這些內容寫在注釋里:
> * 個人隱私信息
> * 用戶名、郵箱等留名式信息(貢獻信息會自動附加,請不要手動附加您的用戶名等信息)
> * 無關緊要的信息,比如“今天天氣真好”之類
> * 會干擾代碼執行的注釋
> * 對他人閱讀代碼產生干擾的注釋
> * 會使代碼運行緩慢臃腫的注釋
注意:注釋部分的內容不計入貢獻。
### 正確的例子
~~~
{
("你好呀", "你最近怎么樣"),
(LINK_A) // LINK_A 指向的是37行的回答
endl;
}
~~~
~~~
{
("你好呀", "你最近怎么樣"),
(LINK_B)
endl;
}
/* LINK_B 指向的是49行的回答,
LINK_B下只有一個回答 */
~~~
### 反例
1. 用戶名、郵箱等留名式信息(貢獻信息會自動附加,請不要手動附加您的用戶名等信息)
~~~
{
("你好呀", "你最近怎么樣"),
(LINK_C) // 這段是我Example寫的!!
endl;
}
~~~
2. 無關緊要的信息,比如“今天天氣真好”之類
~~~
{
("你好呀", "你最近怎么樣"),
(LINK_D) // 今天天氣還行
endl;
}
~~~
3. 對他人閱讀代碼產生干擾的注釋
~~~
{/* 呵呵 */
/* 呵呵 */
("你好呀", "你最近怎么樣"),/* 呵呵 */
(LINK_E)/* 呵呵 */
endl;/* 呵呵 */
}/* 呵呵 */
~~~
4. 會干擾代碼執行的注釋
~~~
{
("你/*斷*/好/*斷*/呀", "你最/*斷*/近怎/*斷*/么樣"),
(LINK_/*斷*/F)
en/*斷*/dl;
}
~~~
5. 會使代碼運行緩慢臃腫的注釋
~~~
{
("你好呀", "你最近怎么樣"),
(LINK_G)
endl;
}
/* 我認為“你好呀”這句話和長恨歌有很大的聯系
漢皇重色思傾國,御宇多年求不得。
楊家有女初長成,養在深閨人未識。
天生麗質難自棄,一朝選在君王側。
......(省略好多好多好多行)
在天愿作比翼鳥,在地愿為連理枝。
天長地久有時盡,此恨綿綿無絕期。*/
~~~