2016年8月29日 星期一

給新手的C++教學 (上冊) - 13 - 1. 「註解」的使用

回到「給新手的C++教學 (上冊)」

回到「13. 額外語法 (Extra syntax)」

上一頁 (這是第一頁)

如果有一天你想不開 (X) 去看了一年前寫的程式碼,很大的機會你是無法在短時間內就看懂的 (如果不相信的話可以實驗看看^_^)
真的嗎?
那就在寫程式的當下記錄這份程式碼在幹嘛的就好啦~
可是好麻煩喔,這樣有些想解釋更清楚的地方不就要再數數看在第幾行嗎?
例如以下程式碼:

#include<cstdio>
int main()
{
    printf("Hello world!\n");
    return 0;
}

你可能會想 (用Microsoft Word或記事本之類的) 寫個說明存成另一個檔案之類的:

這個程式會輸出「Hello world!\n」
第1行會引入標頭檔「cstdio」
第2行的「int」是主函式的型別
第2行的「main」是主函式的名字
第4行的「printf」是用來輸出的函式名字,兩個「"」裡面是要輸出的字串,所以這一行會讓程式輸出「Hello world!\n」
第5行是讓程式回傳0來正常結束

但是這樣的說明不論修改或閱讀都很麻煩 (因為還要指定或找到第幾行)
而且說明檔和程式碼是分開的,很不好管理
這時,「註解」就很好用了,它可以讓你直接把說明寫在程式碼裡面
用法如下:

/*灰色的字都是註解
它們可以讓你輕易地看出這份程式碼在幹嘛
例如這份程式碼會讓程式輸出「Hello world!\n」*/
#include<cstdio>//引入標頭檔「cstdio」
int main()//int是主函式的型別,main是主函式的名字
{
    printf("Hello world!\n");//輸出「Hello world!\n」
    /*「printf」是用來輸出的函式名字
      兩個「"」裡面是要輸出的字串*/
    return 0;//讓程式回傳0來正常結束
}

這樣就可以很清楚的知道程式的每個地方在做甚麼事了!
當然,註解並不會對原本程式碼的功能產生任何影響,你想寫甚麼就寫甚麼、想寫多少就寫多少!

甚麼,你說你還是覺得另外開檔案存說明比較好?
沒關係,我相信你到最後還是會回來用註解的 ;)

下一頁

感謝:
(版權所有 All copyright reserved)

沒有留言:

張貼留言

歡迎留言或問問題~
若您的留言中包含程式碼,請參考這篇
如果留言不見了請別慌,那是因為被google誤判成垃圾留言,小莫會盡快將其手動還原