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