C語言中注釋與注意事項的示例分析

這篇文章主要介紹了C語言中注釋與注意事項的示例分析，具有一定借鑒價值，感興趣的朋友可以參考下，希望大家閱讀完這篇文章之后大有收獲，下面讓小編帶著大家一起了解一下。

C語言注釋簡介：

注釋應該出現(xiàn)在三種位置

• 文件頭部

• 函數(shù)頭部

• 函數(shù)體內(nèi)的和代碼混在一起的注釋
  

對于文件頭部的注釋至少列出：

• 版權聲明、版本號、文件創(chuàng)建日期、作者、內(nèi)容/功能、與其他文件的關系、修改日志等。

函數(shù)頭部注釋要求至少列出：

• 函數(shù)功能、輸入/輸出參數(shù)、返回值、調(diào)用/被調(diào)用關系等。
  

C語言注釋實例

注釋在預編譯階段就會被刪除掉，但是這里的刪除并不是字面意義的刪除，而是被替換，注釋被替換，本質(zhì)是替換成空格。

以下面的代碼為例：

#include <stdio.h> 
int main() 
{ 
int /* */ i; //正確 
char *s = "abcdefgh   //hijklmn"; //正確 
//Is it a\
  valid comment? //正確 
in/* */t j; //報錯 
return 0; 
}

由于被替換成了空格，所以in t j這句話是無法編譯的。

如果是C語言風格的注釋出現(xiàn)了嵌套，則/*總是與離它最近的*/匹配，第二個/*并不會被認為是注釋符號，因此第一個/*與第一個*/匹配，代碼會剩下一個*/:

注釋的一些注意事項

1. 注釋應當準確、易懂，反之有二義性。錯誤的注釋容易產(chǎn)生誤導，不利于代碼維護。

2. 邊寫代碼邊修改注釋，修改代碼的同時要修改對應的注釋，保證注釋和代碼的一致性。不再有用的注釋要及時刪除。

3. 注釋是對代碼的“提示”，所以注釋應當簡單明了，因為注釋太多會讓人眼花繚亂。

4. 對于全局數(shù)據(jù)（全局變量、常量定義等）必須要加注釋。注釋清楚定義全局數(shù)據(jù)的目的。

5. 注釋的位置應該與被描述的代碼相鄰，可以與語句在同一行，也可以在語句的上一行，但不能在語句的下一行，因為這樣不符合人的閱讀習慣。

6. 當代碼比較長，特別是有多重嵌套時，應當在一些段落結束時加注釋，便于閱讀。

7. 注釋的縮進要與代碼的縮進一致，這樣代碼會更美觀，可讀性強。

8. 注釋代碼段時應當注重“為何做”而不是“怎么做”，要說明這段代碼的操作意圖。

9. 數(shù)值的單位一定要注釋。

10. 對變量的范圍給出注釋，特別是參數(shù)。

11. 對一系列的數(shù)字編號給出注釋，尤其是在編寫底層驅(qū)動的程序。

12. 避免在一行代碼或表達式的中間插入注釋。

13. 復雜的函數(shù)中，在分支語句、循環(huán)語句結束之后需要加注釋，方便區(qū)分各分支或循環(huán)體。
    

感謝你能夠認真閱讀完這篇文章，希望小編分享的“C語言中注釋與注意事項的示例分析”這篇文章對大家有幫助，同時也希望大家多多支持億速云，關注億速云行業(yè)資訊頻道，更多相關知識等著你來學習!