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