《C語言程式設計初學者指南》一1.3 使用注釋

本節書摘來自異步社群《c語言程式設計初學者指南》一書中的第1章，第1.3節，作者【美】keith davenport（達文波特） , m1ichael vine（維恩），更多章節内容可以通路雲栖社群“異步社群”公衆号檢視

在任何程式設計語言中，注釋都是程式代碼的一個組成部分。注釋幫助表明程式的作用并且說明複雜的例程。無論是對于程式員本人（也就是你），還是檢視你的代碼的其他程式員來說，注釋都很有用。

在下面的代碼行中，編譯器會忽略掉文本“c programming for the absolute beginner”，因為這行文本用字元/和/括了起來。

字元/表示一個注釋塊的開始，而/表示一個注釋塊的結束。這些字元并不一定要在同一行中，它們可以用來建立單行注釋，也可以用于多行注釋。如下的代碼塊展示了一個多行注釋：

如果你漏掉了某一個注釋字元，或者把某個注釋字元用反了，c程式将無法正确地編譯，或者根本就不會編譯。例如，如下的代碼段漏掉了一個注釋字元，編譯器不會編譯它。

下面這行代碼也不會被編譯，因為注釋字元的順序不對：

技巧

　

如果你記不住注釋符号的正确順序，可以把它們想象為兩個拿着球棒面對面打球的人。球棒（/）總是需要把球（*）打向另一個球棒，并且球還沒有離開球棒而遠去。

如果你的注釋并不需要跨越多行，可以選擇直接在注釋之前使用雙斜杠（//），如下所示：

陷阱

如果你的c編譯器支援c++（gcc就支援），可以使用單行注釋字元//來表示單行的注釋。注意，并不是所有的c編譯器都支援單行注釋字元。

編譯器會忽略掉//字元之後的、同一行中的任何字元。也可以使用//字元來建立多行注釋，但是這樣一來，在語句塊中的每一行的前面，都需要使用雙斜杠。例如，下面的代碼建立了一個多行的注釋塊。