??? ??? 在C/C++中,變量及函數的定義一般都是在.h/.hpp文件中說明原型,而在對應的.c/.cpp文件中來進行實現.
??? ??? 這種情況下,頭文件最終是給用戶使用的,以便讓用戶了解有哪些接口可以使用;而.c/.cpp文件是開發者使用的,以便讓其它開發人員了解它的實現邏輯.因此這兩個文件中肯定都是需要詳細的注釋的.在.h/.hpp文件中,主要說明函數的使用方法,如參數的意義,返回值的定義等.而.c/.cpp文件中,主要說明函數的實現邏輯等.
??? ??? 不知道上面的做法是否合適.請大家指正!
??? ??? 另外,大家在實際編程過程中是如何做的?
??? ??? 事實上,我自己在實踐過程中卻總是偏向于把注釋寫到一個地方,或者注釋原型,或者注釋實現(前者比較多),甚至干脆兩邊都寫一樣的(但這樣的話內容經常會不一樣).這樣的方法讓我在編程過程中吃盡了苦頭哇.