C語言教學02 - 註解

撰寫於2018年9月

現代C語言小心得

註解

註解是一個可以解釋程式碼的工具。型態有以下兩種：

C語言風格註解

這是傳統的註解

/* 裡面是註解 */
/* 這種註解可以
   跨行
*/
int alpha; /* 你也可以這樣寫 */

註解不能巢狀
例如：

/*
/*
  這是不行的
*/
*/

C++風格註解

C99以後支援C++風格註解

// 這種註解只有一行
int alpha; // 你也可以寫在東西後面

何時要註解

註解的目標是解釋程式碼，我們會希望自己的程式碼可以被其他人看懂，所以會適當的利用註解。但我們不會濫用註解，或是用逐行逐字地將程式碼翻譯成自然語言，這樣作是沒有意義的，這種情況，我們就該利用良好寫作的程式，用程式碼自行解釋程式碼。