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